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.

Want more support for this feature? Tell us why.

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