document.embeds is a read-only property that returns a live HTMLCollection of every <embed> element in the document (MDN).
Read the notes below before you get or set this property. Prefer feature detection when support is limited.
Use document.embeds. Start with this line.
document.embeds| Call | What it does |
|---|---|
document.embeds | Primary signature. |
Built into the browser. Read or assign document.embeds — no import required.
document.embeds| Parameter | Description |
|---|---|
| Writable? | Optional. Read-only |
| Return Value | Description |
|---|---|
| * | Live HTMLCollection |
embeds.lengthCount every <embed> on the page.
const count = document.embeds.length;
console.log("embed count:", count);
if (count === 0) {
console.log("No <embed> elements on this page");
}document.embeds. Live HTMLCollection of embeds (MDN)..length. Number of <embed> tags only.count === 0 before indexing.srcInspect every embed’s resource URL.
for (const el of document.embeds) {
console.log(el.tagName, el.src || "(no src)");
}HTMLEmbedElement.src. Resource URL for that embed.|| "(no src)" when the attribute is missing.document.embeds[i] is fine everywhere.plugins AliasProve the collection grows when you append an embed, and matches plugins.
const before = document.embeds.length;
const el = document.createElement("embed");
el.src = "https://example.com/demo.pdf";
el.type = "application/pdf";
document.body.appendChild(el);
console.log(before, "→", document.embeds.length);
console.log("same as plugins?", document.embeds === document.plugins);length before the change.embed. DOM update is enough.length again. Live collection increases by one.plugins. Same object in modern HTML (MDN / HTML standard).Document.embeds is marked Baseline Widely available on MDN (since June 2018). Logos use the shared browser-image-sprite.png sprite from this project.
Read-only live HTMLCollection of every <embed> element in the document.
Bottom line: Use document.embeds to list every embed on a page. It excludes iframe/object/video — and document.plugins points at the same collection. See the MDN Document.embeds reference.
Inspect Permissions Policy with the FeaturePolicy API.
11 people found this page helpful