chrome.search

설명

chrome.search API를 사용하여 기본 제공자를 통해 검색합니다.

권한

search

지원 대상

Chrome 87 이상

유형

Disposition

열거형

"CURRENT_TAB"
검색 결과가 활성 브라우저의 호출 탭 또는 탭에 표시되도록 지정합니다.

"NEW_TAB"
검색 결과가 새 탭에 표시되도록 지정합니다.

"NEW_WINDOW"
검색결과가 새 창에 표시되도록 지정합니다.

QueryInfo

속성

  • disposition

    처리 선택사항

    검색결과가 표시될 위치입니다. 기본값은 CURRENT_TAB입니다.

  • tabId

    number 선택사항

    검색결과가 표시될 위치입니다. tabId는 disposition와 함께 사용할 수 없습니다.

  • text

    string

    기본 검색 공급자로 쿼리할 문자열입니다.

방법

query()

프로미스 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

기본 검색 공급자를 쿼리하는 데 사용됩니다. 오류가 발생하면 runtime.lastError가 설정됩니다.

매개변수

  • queryInfo

    QueryInfo

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    ()=>void

반환 값

  • Promise<void>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.