VideoFrame: clone() method

Baseline 2024
Newly available

Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Note: This feature is available in Dedicated Web Workers.

The clone() method of the VideoFrame interface creates a new VideoFrame object referencing the same media resource as the original.

Syntax

js
clone()

Parameters

None.

Return value

A new cloned VideoFrame object.

Exceptions

InvalidStateError DOMException

Thrown if the VideoFrame object has been transferred.

Examples

The following example clones a copy of VideoFrame as videoFrame2.

js
let videoFrame2 = VideoFrame.clone();

Specifications

Specification
WebCodecs
# dom-videoframe-clone

Browser compatibility