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()

Promise 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

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

매개변수

  • filter

    필터 선택사항

  • callback

    함수 선택사항

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

    (devices: Device[]) => void

    • 기기

      기기[]

      동기화된 각 세션의 sessions.Device 객체 목록으로, 가장 최근에 수정된 세션이 있는 기기에서 가장 최근에 수정되지 않은 세션이 있는 기기 순으로 정렬됩니다. tabs.Tab 객체는 sessions.Session 객체의 windows.Window에서 최근순으로 정렬됩니다.

반환 값

  • Promise<Device[]>

    Chrome 96 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getRecentlyClosed()

Promise 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

매개변수

  • filter

    필터 선택사항

  • callback

    함수 선택사항

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

    (sessions: Session[]) => void

    • sessions

      세션[]

      닫힌 항목의 목록으로, 닫힌 순서대로 역순으로 표시됩니다 (가장 최근에 닫힌 탭 또는 창은 색인 0에 있음). 항목에는 탭 또는 창이 포함될 수 있습니다.

반환 값

  • Promise<Session[]>

    Chrome 96 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

매개변수

반환 값

  • Promise<Session>

    Chrome 96 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onChanged

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

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

매개변수

  • callback

    함수

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

    () => void