extensionTypes.ImageDetails

有关捕获图片格式、质量、区域和比例的详细信息。

类型

该类型的取值是对象,包含下列属性:

format 可选

extensionTypes.ImageFormat。结果图片的格式,默认为 "png"

quality 可选

integer。当格式是 "jpeg" 时,这将决定结果图片的质量。这应是 0—100 之间的数字,并将被转换为 0—1 之间的取值作为 HTMLCanvasElement.toDataURL() 方法的 encoderOptions 参数传递给函数。在属性被忽略时将采用 92 作为默认取值。随着质量的降低,结果图片将有更多视觉伪影,存储所需的字节数也将减少。当图片格式设置为 PNG 时,该值将被忽略。

rect 可选

object,指定要捕获的文档区域,单位为 CSS 像素,相对于页面。所有属性默认为 0。这些属性是:

  • x:矩形左侧的坐标。
  • y:矩形顶部的坐标。
  • width:矩形的宽度。
  • height:矩形的高度。

该选项在 Firefox 82 中引入。若省略该属性,则将捕获当前可视视口。

scale 可选

number,渲染的比例,默认为 devicePixelRatio。该选项在 Firefox 82 中引入。

浏览器兼容性

BCD tables only load in the browser

备注: 此 API 基于 Chromium 的 chrome.extensionTypes API。该文档衍生自 Chromium 代码中的 extension_types.json