chrome.search

refresh date: 2026-09-25 robots: noindex

תיאור

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

הרשאות

search

זמינות

‫Chrome מגרסה 87 ואילך

סוגים

Disposition

טיפוסים בני מנייה (enum)

"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

  function optional

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

  () => void

החזרות

• Promise<void>

  ‫Chrome מגרסה 96 ואילך

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).