修正會影響搜尋體驗的 JavaScript 問題

本指南可協助您辨識特定 JavaScript 問題並進行修正,避免您的網頁或 JavaScrpit 網頁上的特定內容因為有這類問題,而無法顯示在 Google 搜尋結果中。此外,由於 Googlebot 能夠執行 JavaScript,所以您在設計網頁和應用程式時還需要考量一些不同的情況和限制,讓檢索器能順利存取並轉譯您的內容。

Googlebot 有如一個良善的網路公民,主要任務是檢索網站,同時確保檢索作業不會導致網站的使用體驗大打折扣。Googlebot 與其網路轉譯服務 (WRS) 元件會持續分析並找出不屬於基本網頁內容的資源,從而避免擷取這類資源。舉例來說,這類資源包括不屬於基本網頁內容的報表和錯誤要求,以及作用與擷取基本網頁內容無關或非必要的其他類似要求。

如果您懷疑您的網頁或 JavaScript 網頁上的特定內容可能是因為 JavaScript 問題才受到封鎖,所以無法顯示在 Google 搜尋結果中,請按照下列步驟操作:

  1. 如要測試 Google 檢索及轉譯網址的情況,請使用 Search Console 中的行動裝置相容性測試網址檢查工具。您可以點選網頁評定資訊卡上的更多資訊連結,查看載入的資源、JavaScript 控制台輸出結果和例外狀況、已轉譯的 DOM 以及其他資訊。

    此外,我們也建議收集使用者 (包括 Googlebot) 在您的網站上遇到的 JavaScript 錯誤並進行稽核,以便找出可能影響內容轉譯的潛在問題。

  2. 預期 Googlebot 會拒絕使用者權限要求
  3. 請勿依賴資料持續性來提供內容。
  4. 務必讓您的應用程式對所有需要的重要 API 執行功能偵測,並視情況提供備援行為或 Polyfill。
  5. 確保您的網路元件易於使用者搜尋:
    1. 如要壓縮及隱藏實作詳細資料,請使用 shadow DOM
    2. 儘可能將您的內容放入 light DOM
  6. 當您修正這份檢查清單中的問題後,請再次使用 Search Console 中的行動裝置相容性測試網址檢查工具對網頁進行測試。

    如果您已修正問題,就只會看到綠色勾號。如果仍有錯誤項目,請前往 JavaScript Sites in Search Working Group 張貼問題。