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