OffscreenCanvas: convertToBlob()-Methode

Syntax

convertToBlob()
convertToBlob(options)

Parameter

options Optional

Ein Objekt mit den folgenden Eigenschaften:

type

Ein String, der das Bildformat angibt. Der Standardtyp ist image/png; dieses Bildformat wird auch verwendet, wenn der angegebene Typ nicht unterstützt wird.

quality

Eine Number zwischen 0 und 1, die die Bildqualität angibt, die beim Erstellen von Bildern mit Dateiformaten verwendet werden soll, die verlustbehaftete Kompression unterstützen (wie image/jpeg oder image/webp). Ein Benutzeragent verwendet seinen Standardwert für die Qualität, wenn diese Option nicht angegeben wird oder wenn die Zahl außerhalb des erlaubten Bereichs liegt.

Rückgabewert

Ein Promise, der ein Blob-Objekt zurückgibt, das das im Canvas enthaltene Bild darstellt.

Ausnahmen

Das Versprechen kann mit den folgenden Ausnahmen abgelehnt werden:

InvalidStateError DOMException

Der OffscreenCanvas ist nicht getrennt; mit anderen Worten, er ist noch mit dem DOM und nicht mit dem aktuellen Worker verbunden.

SecurityError DOMException

Der Canvas-Kontextmodus ist 2d und das Bitmap ist nicht origin-clean; mindestens einige seiner Inhalte wurden oder könnten von einer anderen Seite als der geladen worden sein, von der das Dokument selbst geladen wurde.

IndexSizeError DOMException

Das Canvas-Bitmap hat keine Pixel (entweder die horizontale oder vertikale Dimension ist null).

EncodingError DOMException

Der Blob konnte aufgrund eines Kodierungsfehlers nicht erstellt werden.

Beispiele

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" }

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die Schnittstelle, die diese Methode definiert, OffscreenCanvas.