find.highlightResults()

高亮顯示先前呼叫 find.find() 的結果。

當擴充套件呼叫 find() 時,匹配項不會自動高亮,但會被瀏覽器儲存。呼叫 highlightResults() 來高亮它們。

請注意,儲存的結果是全域性的,所有擴充套件共享。因此,例如,如果擴充套件 A 呼叫 find("apple"),然後擴充套件 B 呼叫 find("banana"),之後擴充套件 A 呼叫 highlightResults(),則會高亮顯示“banana”的結果。

語法

js
browser.find.highlightResults(
  options // optional object
)

引數

options 可選

object。一個指定額外選項的物件。它可能包含以下任意屬性,所有屬性都是可選的

tabId

integer。要高亮的標籤頁 ID。預設為當前活動標籤頁。

rangeIndex

integer。要高亮的範圍索引。預設為高亮所有範圍。

noScroll

boolean。不要滾動到高亮項。預設為 true

返回值

無。

示例

在當前標籤頁中搜索“banana”,記錄匹配項數量,並高亮顯示它們

js
function found(results) {
  console.log(`There were: ${results.count} matches.`);
  if (results.count > 0) {
    browser.find.highlightResults();
  }
}

browser.find.find("banana").then(found);

瀏覽器相容性