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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.