chrome.sessions

설명

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

권한

sessions

유형

Device

속성

  • deviceName

    string

    외부 기기의 이름입니다.

  • 세션

    세션[]

    외부 기기의 열린 창 세션 목록으로, 최근 수정된 세션부터 가장 오래된 세션까지 정렬되어 있습니다.

Filter

속성

  • maxResults

    number 선택사항

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

Session

속성

  • lastModified

    숫자

    창이나 탭이 닫히거나 수정된 시간으로, 에포크 이후 밀리초로 표시됩니다.

  • 탭

    Tab 선택사항

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

  • 창

    기간 선택사항

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

속성

MAX_SESSION_RESULTS

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

값

25

방법

getDevices()

프로미스 
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()

프로미스 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

매개변수

  • filter

    필터 선택사항

  • 콜백

    함수 선택사항

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

    (sessions: Session[])=>void

    • 세션

      세션[]

      닫은 항목 목록을 닫은 순서와 반대로 표시합니다 (가장 최근에 닫은 탭 또는 창의 색인은 0이 됨). 항목에는 탭 또는 창이 포함될 수 있습니다.

반환 값

  • 프로미스<세션[]>

    Chrome 96 이상

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

restore()

프로미스 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

windows.Window 또는 tabs.Tab를 다시 엽니다. 항목이 복원되었을 때 실행할 콜백은 선택사항입니다.

매개변수

반환 값

  • Promise<세션>

    Chrome 96 이상

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

이벤트

onChanged

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

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

매개변수

  • 콜백

    기능

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

    ()=>void