ImageBitmap.close()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ImageBitmap.close() method disposes of all graphical resources associated with an ImageBitmap.

Syntax

close()

Parameters

None.

Return value

None (undefined).

Examples

var offscreen = new OffscreenCanvas(256, 256);
var gl = offscreen.getContext('webgl');

// ... some drawing using the gl context ...

var bitmap = offscreen.transferToImageBitmap();
// ImageBitmap { width: 256, height: 256 }

bitmap.close();
// ImageBitmap { width: 0, height: 0 } -- disposed

Specifications

Specification
HTML Standard
# dom-imagebitmap-close-dev

Browser compatibility

BCD tables only load in the browser

See also