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

CKTIS / JavaScript

Selection.getRangeAt — извличане на диапазон от селекцията

Selection.getRangeAt(0) връща обекта Range, свързан със селекцията в документа, а не негово копие.

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

Синтаксис

selection.getRangeAt(index)

selection.getRangeAt(index) предоставя достъп до диапазона на селекцията. Това е браузърно Web API, а не функционалност на ECMAScript; Node 24 не потвърждава поддръжката му.

Преди извикване с индекс 0 проверете дали са изпълнени условията selection !== null и selection.rangeCount > 0. Според спецификацията методът трябва да хвърли изключение IndexSizeError, ако индексът е различен от 0, селекцията е празна или някоя от граничните ѝ точки е извън дървото на документа. Браузърите не винаги спазват това правило: Firefox може да предостави достъп до няколко диапазона в селекцията, така че ненулев индекс също може да сработи. Ако гранична точка се намира в дърво на Shadow DOM, не разчитайте, че браузърът ще хвърли това изключение. Селекция, свита до позицията на курсора, все пак може да има диапазон.

Резултатът е референция: промяната на диапазона влияе върху селекцията, докато остават свързани. Повторните извиквания с един и същ индекс връщат същия обект, освен ако диапазонът не е заменен или премахнат. Спецификацията е Working Draft, а не таблица за съвместимост на браузърите.

Примери

(() => {
  const selection = window.getSelection();
  if (!selection || !document.body) {
    throw new Error("An active browser document is required.");
  }

  const element = document.createElement("p");
  element.textContent = "Hello world";
  document.body.append(element);

  try {
    selection.removeAllRanges();
    const range = document.createRange();
    range.setStart(element.firstChild, 0);
    range.setEnd(element.firstChild, 5);
    selection.addRange(range);

    if (selection.rangeCount === 0) {
      throw new Error("No selection range is available.");
    }
    const selectedRange = selection.getRangeAt(0);
    console.log(selectedRange.toString());
    console.log(selectedRange === selection.getRangeAt(0));
  } finally {
    selection.removeAllRanges();
    element.remove();
  }
})();

Резултат

Hello
true

Кодът и изходът са проверени в изолирана среда с Chromium. Примерът извлича единствения диапазон с индекс `0` и проверява дали второ извикване връща същия обект. Той не проверява ненулеви индекси или гранични точки в дърво на Shadow DOM.

Източници