HTMLIFrameElement.setVisible()

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The setVisible() method of the HTMLIFrameElement is used to change the visibility state of the browser <iframe>.

The visible state of a browser <iframe> has nothing to do with its actual visibility (which is handled through CSS). The visible state is used to define the level of resources required by the browser <iframe>. If the visible state is set to true, it means that the browser <iframe> should have high priority over the resources needed to render and handle its content. On the contrary, if its visible state is set to false, it has low priority over the resources it needs.

As an example, if the content of a browser <iframe> uses the window.requestAnimationFrame method and if the visible state is set to true, window.requestAnimationFrame will be called as often as necessary. However, if the visible state is set to false, window.requestAnimationFrame will be called only when there are free resources to do it.

Syntax

instanceOfHTMLIframeElement.setVisible(visible);

Returns

Void.

Parameters

visible
A Boolean that indicates if the browser <iframe> visible state is true or false.

Examples

var browser = document.querySelector('iframe');

browser.setVisible(true);

Specification

Not part of any specification.

Browser compatibility

Supported since Firefox 47, in chrome code only.

Unlikely ever to be supported in other browsers.

See also