База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

window.getSelection() — избиране в документа

window.getSelection() предоставя достъп до обекта Selection на текущия документ, за да можете да четете и променяте избраното.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

window.getSelection()

window.getSelection() не приема аргументи и делегира към document.getSelection(). Според спецификацията методът връща обект Selection или null, ако документът няма контекст за сърфиране. Firefox обаче може да върне null и за елемент iframe с display:none, въпреки че документът на елемента има контекст за сърфиране. Преди да използвате резултата, проверете дали не е null. Обектът Selection не е низ; прочетете текста чрез selection.toString().

Липсата на избрано съдържание не означава, че резултатът е null: проверете rangeCount, преди да извикате getRangeAt(0), за да избегнете IndexSizeError. isCollapsed показва дали крайните точки съвпадат; това може да означава каретка или празна селекция. Range описва граници, докато Selection представя избраното в документа.

Това е Web API на браузъра, а не функция на ECMAScript. Наличието на Node 24 не доказва, че API се поддържа. Спецификацията на Selection API е работен проект, а не таблица за съвместимост на браузърите.

Примери

(() => {
  const selection = window.getSelection();
  if (!selection) throw new Error("Selection unavailable");

  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello selection";
  document.body.append(paragraph);

  const range = document.createRange();
  range.selectNodeContents(paragraph);
  selection.removeAllRanges();
  selection.addRange(range);

  console.log(selection.toString());
  console.log(selection.isCollapsed);

  selection.removeAllRanges();
  paragraph.remove();
})();

Резултат

Hello selection
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници