Selection: deleteFromDocument() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
The deleteFromDocument()
method of the
Selection
interface invokes the Range.deleteContents()
method on the selected Range
.
Syntax
js
deleteFromDocument()
Parameters
None.
Return value
None (undefined
).
Examples
This example lets you delete selected text and/or nodes by clicking a button. Upon clicking the
button, the
Window.getSelection()
method gets the selected content, and the
deleteFromDocument()
method removes it.
HTML
html
<p>Try highlighting some of the elements in these paragraphs.</p>
<p>
Once you do, you can remove the selected content by clicking the button below.
</p>
<h2>All of the selected text/nodes will be removed.</h2>
<button>Delete selected text</button>
JavaScript
js
let button = document.querySelector("button");
button.addEventListener("click", deleteSelection);
function deleteSelection() {
let selection = window.getSelection();
selection.deleteFromDocument();
}
Result
Specifications
Specification |
---|
Selection API # dom-selection-deletefromdocument |
Browser compatibility
BCD tables only load in the browser
See also
Selection
, the interface defining this method