HTMLSlotElement: assignedElements() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

The assignedElements() method of the HTMLSlotElement interface returns a sequence of the elements assigned to this slot (and no other nodes).

If the flatten option is set to true, it returns a sequence of both the elements assigned to this slot, as well as the elements assigned to any other slots that are descendants of this slot. If no assigned elements are found, it returns the slot's fallback content.

Syntax

js
assignedElements()
assignedElements(options)

Parameters

options Optional

An object that sets options for the nodes to be returned. The available options are:

flatten

A boolean value indicating whether to return the assigned elements of any available child <slot> elements (true) or not (false). Defaults to false.

Return value

An array of elements.

Examples

js
let slots = this.shadowRoot.querySelector("slot");
let elements = slots.assignedElements({ flatten: true });

Specifications

Specification

HTML
# dom-slot-assignedelements-dev

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Jun 23, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content