The Selection.containsNode() method indicates whether a specified node is part of the selection.
The Selection.containsNode() method indicates whether a specified node is part of the selection.
js
containsNode(node) containsNode(node) containsNode(node, partialContainment)
nodeThe node that is being looked for in the selection.
partialContainment Optional
When true, containsNode() returns true when a part of the node is part of the selection. When false, containsNode() only returns true when the entire node is part of the selection. If not specified, the default value false is used.
Returns true if the given node is part of the selection, and false otherwise.
This snippet checks whether anything inside the body element is selected.
js
console.log(window.getSelection().containsNode(document.body, true));
In this example, a message appears when you select the secret word. It uses addEventListener() to check for selectionchange events.
html
<p>Can you find the secret word?</p> <p> Hmm, where <span id="secret" style="color:transparent">SECRET</span> could it be? </p> <p id="win" hidden>You found it!</p>
js
const secret = document.getElementById("secret"); const win = document.getElementById("win"); // Listen for selection changes document.addEventListener("selectionchange", () => { const selection = window.getSelection(); const found = selection.containsNode(secret); win.toggleAttribute("hidden", !found); });
| Specification |
|---|
| Selection API # dom-selection-containsnode |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
containsNode |
1 | 12 | 1Before Firefox 35, the method didn't throw ifnode was null. |
No | ≤12.1 | 3.1 | 4.4 | 18 | 4Before Firefox 35, the method didn't throw ifnode was null. |
≤12.1 | 2 | 1.0 |
partialContainment_parameter_optional |
1 | ≤79 | 55 | No | ≤15 | 3.1 | ≤37 | 18 | 55 | ≤14 | 2 | 1.0 |
Selection, the interface it belongs to.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Selection/containsNode