HTML - DOM Document embeds Property



HTML DOM document embeds is a read-only property used for returning all the <embed> elements present within HTML document as a collection.

Syntax

document.embeds;

Properties

Property Description
length It return the number of <embed> element present in HTML document.

Methods

Below table shows a list of methods offered by DOM embeds.

Methods Description
[index] To return the <embed> element from the collection at the given index. Indexing starts from 0 and null is returned if the index is out of bound.
item(index) To return the <embed> element from the collection at the given index. Indexing starts from 0 and null is returned if the index is out of range. It is similar to first method.
namedItem(id) To return the <embed> element from the collection with the given id. Null is returned if the id doesnt exist.

Return value

It returns an HTMLCollection which lists all the <embed> elements present in the document.The elements present in the collection are sorted and are presented in the same order as they appear in the HTML document.

Examples of HTML DOM Document 'embeds' Property

The following examples illustrates use of embeds properties and methods.

Get number of Embedded Elements

In the following example, length property is used to return the number of <embed> elements in document.

<!DOCTYPE html>
<html lang="en">
<head>
    <title>HTML DOM document embeds Property</title>
</head>
<body>
    <embed src="/html/images/test.png" type="image/jpg">
    <embed src="/plsql/images/plsql-mini-logo.jpg" type="image/jpg">
    <embed src="/html/images/html.jpg" type="image/jpg">
    <p>Click to get the number of <embed> element.</p>
    <button onclick="fun()">Click me</button>
    <p id="embeds"></p>
    <script>
        function fun() {
            let x = document.embeds.length;
            document.getElementById("embeds").innerHTML = x;
        }
    </script>
</body>
</html>

Get URL of First Embedded Element

In this example, we will get the URL of the first embedded file using embeds [index] method.

<!DOCTYPE html>
<html lang="en">
<head>
    <title>HTML DOM document embeds Property</title>
</head>
<body>
    <embed src="/html/images/test.png" type="image/jpg">
    <embed src="/plsql/images/plsql-mini-logo.jpg" type="image/jpg">
    <embed src="/html/images/html.jpg" type="image/jpg">
    <p>Click to get URL of the first embedded file</p>
    <button onclick="fun()">Click me</button>
    <p id="embeds"></p>
    <script>
        function fun() {
            let x = document.embeds[0].src;
            document.getElementById("embeds").innerHTML = x;
        }
    </script>
</body>
</html>

Get URL of any Embedded Element

In this example, we will get the URL of the second embedded file using embeds item(index) method.

<!DOCTYPE html>
<html lang="en">
<head>
    <title>HTML DOM document embeds Property</title>
</head>
<body>
    <embed src="/html/images/test.png" type="image/jpg">
    <embed src="/plsql/images/plsql-mini-logo.jpg" type="image/jpg">
    <embed src="/html/images/html.jpg" type="image/jpg">
    <p>Click to get URL of the first embedded file</p>
    <button onclick="fun()">Click me</button>
    <p id="embeds"></p>
    <script>
        function fun() {
            let x = document.embeds.item(1).src;
            document.getElementById("embeds").innerHTML = x;
        }
    </script>
</body>
</html>   

Get class name of Embedded Element

In this example, we will get the class name of the third embedded file using embeds namedItem(id) method.

<!DOCTYPE html>
<html lang="en">
<head>
    <title>HTML DOM document embeds Property</title>
</head>
<body>
    <embed src="/html/images/test.png" type="image/jpg">
    <embed src="/plsql/images/plsql-mini-logo.jpg" type="image/jpg">
    <embed src="/html/images/html.jpg" type="image/jpg" id="id3" class="js">
    <p>Click to get class name of the third embedded file</p>
    <button onclick="fun()">Click me</button>
    <p id="embeds"></p>
    <script>
        function fun() {
            let x = document.embeds.namedItem("id3").className;
            document.getElementById("embeds").innerHTML = x;
        }
    </script>
</body>
</html>

Supported Browsers

Property Chrome Edge Firefox Safari Opera
embeds Yes 64 Yes 12 Yes 1 Yes 10.1 Yes 51
html_dom.htm
Advertisements