Window: getSelection() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

Window 介面的 getSelection() 方法返回與視窗的 document 關聯的 Selection 物件，該物件表示使用者選擇的文字範圍或插入符的當前位置。

語法

getSelection()

返回值

一個 Selection 物件，如果關聯的文件沒有瀏覽上下文（例如，視窗是未附加到文件的 <iframe>），則返回 null。

當在未顯示的 <iframe> 上呼叫時（例如，設定了 display: none），Firefox 返回 null，而其他瀏覽器則返回一個 Selection 物件，其 Selection.type 設定為 None。

示例

function foo() {
  const selObj = window.getSelection();
  alert(selObj);
  const selRange = selObj.getRangeAt(0);
  // do stuff with the range
}

注意

Selection 物件的字串表示形式

在 JavaScript 中，當一個物件被傳遞給一個需要字串的函式時（例如 window.alert() 或 document.write()），該物件的 toString() 方法會被呼叫，並返回值傳遞給函式。當物件與其他函式一起使用時，它可能看起來像一個字串，但實際上它是一個具有屬性和方法的物件。

在上面的示例中，當 selObj 被傳遞給 window.alert() 時，會自動呼叫 selObj.toString()。然而，嘗試直接在 Selection 物件上使用 JavaScript String 屬性或方法（如 length 或 substr）將導致錯誤（如果它沒有該屬性或方法），並且如果它確實有，也可能返回意外的結果。要將 Selection 物件用作字串，請直接呼叫其 toString() 方法。