Firefox Tomorrow

web api instance method

Selection: deleteFromDocument() method

View on MDN ↗

The deleteFromDocument() method of the Selection interface invokes the deleteContents() method on the selected Range.

Syntax

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 getSelection() method gets the selected content, and the deleteFromDocument() method removes it.

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

let button = document.querySelector("button");
button.addEventListener("click", deleteSelection);

function deleteSelection() {
  let selection = window.getSelection();
  selection.deleteFromDocument();
}

Result

Interactive exampleOpen the canonical MDN source to run this embedded demo.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also

  • Selection, the interface defining this method