Clients: matchAll() 메서드
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018년 4월.
참고 : This feature is only available in Service Workers.
Clients 인터페이스의 matchAll() 메서드는
서비스 워커 Client 객체의 목록을 Promise로 반환합니다.
options 매개변수를 포함하면 서비스 워커와 출처가 동일한 모든 서비스 워커 클라이언트를 반환할 수 있습니다.
옵션을 포함하지 않으면, 메서드는 서비스 워커가 제어하는 서비스 워커 클라이언트만 반환합니다.
구문
matchAll()
matchAll(options)
매개변수
optionsOptional-
매칭 작업에 대한 옵션을 설정할 수 있는 옵션 객체. 사용 가능한 옵션은 다음과 같습니다.
includeUncontrolled-
불리언 값.
true로 설정하면, 현재 서비스 워커와 동일한 출처를 공유하는 모든 서비스 워커 클라이언트를 반환합니다. 그렇지 않으면, 현재 서비스 워커가 제어하는 서비스 워커 클라이언트만 반환합니다. 기본 값은false입니다. type-
매칭하고자 하는 클라이언트 유형을 설정합니다. 사용 가능한 값은
"window","worker","sharedworker","all"입니다. 기본 값은"window"입니다.
반환 값
Client 객체 배열로 이행된 Promise.
Chrome 46/Firefox 54와 이후 버전에서, 이 메서드는 사양에 따라 가장 최근에 포커스된 순서대로 클라이언트를 반환합니다.
예제
clients.matchAll(options).then((clientList) => {
for (const client of clientList) {
if (client.url === "index.html") {
clients.openWindow(client);
// 또는 일치하는 클라이언트와 관련된 다른 작업을 수행합니다.
}
}
});
명세서
| Specification |
|---|
| Service Workers # clients-matchall |
브라우저 호환성
Loading…