OffscreenCanvas: convertToBlob() 方法

語法

convertToBlob()
convertToBlob(options)

引數

options 可選

具有以下屬性的物件：

type

一個指示影像格式的字串。預設型別是 image/png；如果指定的型別不受支援，也將使用此影像格式。

quality

一個介於 0 和 1 之間的 Number，指示在使用支援有失真壓縮的檔案格式（如 image/jpeg 或 image/webp）建立影像時要使用的影像質量。如果未指定此選項，或者該數字超出了允許的範圍，則使用者代理將使用其預設質量值。

返回值

一個返回 Blob 物件的 Promise，該物件代表 Canvas 中包含的影像。

異常

該 Promise 可能會因為以下異常而被拒絕：

InvalidStateError DOMException

OffscreenCanvas 未分離；換句話說，它仍然與 DOM 相關聯，而不是與當前工作執行緒相關聯。

SecurityError DOMException

Canvas 上下文模式為 2d，並且點陣圖不是源淨的；至少部分內容已從載入文件的站點以外的其他站點載入，或者可能已載入。

IndexSizeError DOMException

Canvas 點陣圖沒有畫素（水平或垂直尺寸為零）。

EncodingError DOMException

由於編碼錯誤，無法建立 blob。

示例

const offscreen = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("webgl");

// Perform some drawing using the gl context

offscreen.convertToBlob().then((blob) => console.log(blob));
// Blob { size: 334, type: "image/png" }

規範

瀏覽器相容性

另見

• 定義此方法的介面是 OffscreenCanvas。