chrome.sessions

설명

탐색 세션에서 탭과 창을 쿼리하고 복원하려면 chrome.sessions API를 사용합니다.

권한

sessions

유형

Device

속성

  • deviceName

    문자열

    외부 기기의 이름입니다.

  • sessions

    세션[]

    외부 기기의 열린 창 세션 목록으로, 최근 수정된 세션부터 가장 오래된 세션 순으로 정렬됩니다.

Filter

속성

  • maxResults

    숫자 선택사항

    요청된 목록에서 가져올 최대 항목 수입니다. 최대 항목 수 (sessions.MAX_SESSION_RESULTS)를 가져오려면 이 매개변수를 생략합니다.

Session

속성

  • lastModified

    숫자

    창 또는 탭이 닫히거나 수정된 시간으로, 에포크 이후의 경과 시간(밀리초)으로 표시됩니다.

  • 탭

    탭 선택사항

    tabs.Tab(이 항목이 탭을 설명하는 경우) 이 값 또는 sessions.Session.window가 설정됩니다.

  • 창

    기간 선택사항

    windows.Window(이 항목이 기간을 설명하는 경우) 이 값 또는 sessions.Session.tab가 설정됩니다.

속성

MAX_SESSION_RESULTS

요청된 목록에 포함될 최대 sessions.Session 수입니다.

값

25

메서드

getDevices()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

동기화된 세션이 있는 모든 기기를 검색합니다.

매개변수

  • filter

    필터 선택사항

  • 콜백

    함수 선택사항

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

    (devices: Device[]) => void

    • 기기

      기기[]

      동기화된 각 세션의 sessions.Device 객체 목록으로, 세션이 가장 최근에 수정된 기기부터 세션이 가장 적게 수정된 기기 순으로 정렬됩니다. tabs.Tab 객체는 sessions.Session 객체의 windows.Window에서 최신성순으로 정렬됩니다.

반환 값

  • 프로미스<기기[]>

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

getRecentlyClosed()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

최근에 닫은 탭 및 창 목록을 가져옵니다.

매개변수

  • filter

    필터 선택사항

  • 콜백

    함수 선택사항

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

    (sessions: Session[]) => void

    • sessions

      세션[]

      닫힌 항목 역순으로 나열된 항목 목록 (가장 최근에 닫은 탭 또는 창은 색인 0에 있음). 항목에는 탭 또는 창이 포함될 수 있습니다.

반환 값

  • Promise<세션[]>

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

restore()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

항목이 복원되면 실행할 선택적 콜백을 사용하여 windows.Window 또는 tabs.Tab를 다시 엽니다.

매개변수

반환 값

  • Promise&lt;Session&gt;

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

이벤트

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

최근에 닫은 탭이나 창이 변경되면 실행됩니다. 이 이벤트는 동기화된 세션 변경사항을 모니터링하지 않습니다.

매개변수

  • 콜백

    함수

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

    () => void