chrome.search

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

משתמשים ב-chrome.search API כדי לחפש דרך ספק ברירת המחדל.

הרשאות

search

זמינות

‫Chrome 87 ואילך

סוגים

Disposition

ספירה

‫CURRENT_TAB
מציין שתוצאות החיפוש יוצגו בכרטיסייה שבה מתבצעת הקריאה או בכרטיסייה מהדפדפן הפעיל.

‫NEW_TAB
מציין שתוצאות החיפוש יוצגו בכרטיסייה חדשה.

‫"NEW_WINDOW"
מציין שתוצאות החיפוש יוצגו בחלון חדש.

QueryInfo

מאפיינים

  • מחיקה

    Disposition אופציונלי

    המיקום שבו תוצאות החיפוש צריכות להופיע. ברירת המחדל היא CURRENT_TAB.

  • tabId

    מספר אופציונלי

    המיקום שבו תוצאות החיפוש צריכות להופיע. אי אפשר להשתמש ב-tabId עם disposition.

  • text

    מחרוזת

    מחרוזת לשאילתה עם ספק החיפוש שמוגדר כברירת מחדל.

Methods

query()

Promise 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

משמש לשליחת שאילתה לספק החיפוש שמוגדר כברירת מחדל. במקרה של שגיאה, הערך של runtime.lastError יוגדר.

פרמטרים

  • queryInfo

    QueryInfo

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.