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 中引入。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
ImageDetails
rect
scale

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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