WebDriver

이 명세의 여러 부분은 단계별 알고리즘의 관점에서 작성되어 있다. 이러한 알고리즘의 세부 사항은 어떠한 규범적 의미도 갖지 않는다. 구현은 명세와 동등한 출력을 산출하는 한 어떤 구현 전략도 자유롭게 채택할 수 있다. 특히 이 문서의 알고리즘은 성능보다 가독성에 최적화되어 있다.

값을 반환하는 알고리즘이 실패할 수 있는 경우, 이들은 성공 또는 오류를 반환하는 방식으로 작성된다. 성공 값에는 반환된 값을 캡슐화하는 연관된 data 필드가 있고, 반면 오류 값에는 연관된 오류 코드가 있다.

실패할 수 있는 알고리즘을 호출할 때, “Let result be the result of trying to call algorithm”라는 구문은 다음과 동등하다.

1. temp를 algorithm 호출의 결과로 둔다.

2. temp가 오류이면 temp를 반환하고, 그렇지 않으면 result를 temp의 data 필드로 둔다.

object에서 name으로 속성을 가져오기의 결과는 object에 대해 Object.[[GetOwnProperty]](name)를 호출한 결과와 동일한 것으로 정의된다.

object에서 인수 name 및 default로 기본값과 함께 속성을 가져오기의 결과는, object에 대해 Object.[[GetOwnProperty]](name)를 호출한 결과가 undefined가 아닌 값이면 그 결과와 같고, 그렇지 않으면 default와 같은 것으로 정의된다.

object에 대해 인수 name 및 value로 속성 설정은 object에 대해 Object.[[Put]](name, value)를 호출하는 것과 동일한 것으로 정의된다.

JSON Object 타입의 object로 수행하는 JSON 직렬화의 결과는 stringify(object)를 호출한 결과로 정의된다.

text로 수행하는 JSON 역직렬화의 결과는 parse(text)를 호출한 결과로 정의된다.

WebDriver 프로토콜은 명령으로 구성된다. 이 명세에서 정의한 메서드와 템플릿을 가진 각각의 HTTP 요청은 단일 명령을 나타내며, 따라서 각 명령은 단일 HTTP 응답을 생성한다.

명령에 응답하여, 원격 엔드는 원격 엔드 단계라고 알려진 일련의 동작을 실행한다. 이는 원격 엔드가 특정 명령을 받았을 때 수행하는 동작의 순서를 제공한다.

원격 엔드는 클라이언트에서 요청을 읽고 응답을 쓰는 HTTP 서버이며, 일반적으로 TCP 소켓을 통해 동작한다. 이 명세의 목적상, 특정 로컬 엔드와 원격 엔드 사이의 데이터 전송은 연결로 모델링하며, 이 연결에 대해 원격 엔드는 바이트 쓰기 및 바이트 읽기를 할 수 있다. 그러나 이 연결이 정확히 어떻게 동작하고 어떻게 설정되는지는 범위 밖이다.

연결이 설정된 후, 원격 엔드는 다음 단계를 실행해야 한다.

1. While 연결이 닫히지 않은 동안:

   1. 데이터에서 완전한 HTTP 요청을 구성할 수 있을 때까지 연결에서 바이트를 읽는다. [RFC7230]의 요구사항에 따라, 수신한 데이터에서 구성된 요청을 request로 둔다. 완전한 HTTP 요청을 구성할 수 없는 경우, 원격 엔드는 연결을 닫거나, 상태 코드 500의 HTTP 응답을 반환하거나, 오류 코드 unknown error를 가진 오류를 반환해야 한다.

   2. request의 method 및 URL을 인수로 하여 요청을 매칭하는 알고리즘의 결과를 request match로 둔다.

   3. request match가 오류 타입이면, request match의 오류 코드로 오류를 보내고 continue한다.

      그렇지 않으면 command와 URL variables를 request match의 데이터로 둔다.

   4. session을 null로 둔다.

   5. URL variables가 "session id"를 contains하는 경우:

      참고

      이 조건은 특정 세션에서 동작하지 않는 New Session 및 Status 명령과 모든 확장 명령을 제외하려는 것이다.

      1. session id를 URL variables["session id"]로 둔다.

      2. 활성 세션 목록의 각 active session에 대해:

         1. active session의 세션 ID가 session id와 같으면, session을 active session으로 두고 중단한다.

      3. session이 null이면 오류 코드 invalid session id로 오류를 보내고, 그다음 continue한다.

   6. 원격 엔드의 요청 큐에 태스크를 큐잉하여 다음 단계를 실행한다.

      1. 세션이 더 이상 활성 세션 목록에 없으면, 오류를 보낸다. 이때 오류 코드 invalid session id를 사용하고 반환한다.

      2. parameters를 null로 둔다.

      3. request의 method가 POST이면:

         1. request의 body를 인수로 하여 JSON으로 파싱한 결과를 parse result로 둔다. 이 과정이 예외를 던지면, 오류 코드 invalid argument를 가진 오류를 반환하고 이 전체 알고리즘의 1단계로 되돌아간다.

         2. parse result가 Object가 아니면, 오류 코드 invalid argument로 오류를 보내고 이 전체 알고리즘의 1단계로 되돌아간다.

            그렇지 않으면 parameters를 parse result로 둔다.

      4. session으로 탐색 완료 대기를 수행한 결과를 navigate result로 둔다.

      5. navigate result가 오류이면, navigate result의 오류 코드와 같은 오류 코드로 오류를 보내고 반환한다.

      6. command에 대해 session, URL variables 및 parameters로 원격 엔드 단계를 실행하여 얻은 반환값을 response result로 둔다.

      7. response result가 오류이면, response result의 오류 코드와 같은 오류 코드로 오류를 보내고 반환한다.

      8. Assert: response result는 성공이다.

      9. response data를 response result의 data로 둔다.

      10. 상태 200 및 response data로 응답을 보낸다.

error code와 선택적인 error data 딕셔너리로 오류 보내기가 요구될 때, 원격 엔드는 다음 단계를 실행해야 한다.

1. status와 name을 error code에 대한 오류 응답 데이터로 둔다.

2. message를 오류의 이유에 대한 사람이 읽을 수 있는 설명을 포함하는 구현 정의 문자열로 둔다.

3. stacktrace를 오류가 발생한 시점의 활성 스택 프레임에 대한 스택 추적 보고서를 포함하는 구현 정의 문자열로 둔다.

   다음 속성으로 초기화된 새 JSON Object를 body로 둔다.

   "error"

   name

   "message"

   message

   "stacktrace"

   stacktrace

4. 오류 데이터 딕셔너리에 항목이 있으면, 딕셔너리로 채워진 새 JSON Object를 body의 "data" 필드로 설정한다.

5. status와 body를 인수로 하여 응답을 보낸다.

인수 status 및 data로 응답 보내기가 요구될 때, 원격 엔드는 다음 단계를 실행해야 한다.

1. response를 새 응답으로 둔다.

2. response의 HTTP 상태를 status로 설정하고, 상태 메시지를 상태 코드 레지스트리에서 status의 설명에 대응하는 문자열로 설정한다.

3. 다음 값으로 response의 헤더에 name과 value를 설정한다.

   Content-Type

   "application/json; charset=utf-8"

   Cache-Control

   "no-cache"

4. response의 body를 키 "value"가 data로 설정된 JSON Object의 JSON 직렬화를 UTF-8 인코딩한 것으로 둔다.

5. response를 [RFC7230]의 규칙에 따라 직렬화하여 나온 바이트 시퀀스를 response bytes로 둔다.

6. response bytes를 연결에 쓴다.

요청 라우팅은 HTTP 요청에서 해당 요청이 나타내는 명령을 구현하는 데 필요한 일련의 단계로 넘어가는 과정이다.

원격 엔드에는 연관된 URL 접두사가 있으며, 이는 그 원격 엔드에서 WebDriver가 정의한 모든 URL의 접두사로 사용된다. 이는 undefined이거나 path-absolute URL이어야 한다.

method 및 URL이 주어졌을 때 요청을 매칭하기 위해, 다음 단계를 수행해야 한다.

1. 엔드포인트 표의 각 행을 포함하는 목록을 endpoints로 둔다.

2. URL 접두사와 항목의 URI 템플릿을 연결한 것이 URL의 path와 같은 유효한 확장을 갖지 않는 각 항목을 endpoints에서 제거한다.

3. endpoints에 항목이 없으면, 오류 코드 unknown command를 가진 오류를 반환한다.

4. method 열이 method와 같지 않은 각 항목을 endpoints에서 제거한다.

5. endpoints에 항목이 없으면, 오류 코드 unknown method를 가진 오류를 반환한다.

6. 이제 endpoints에는 정확히 하나의 항목이 있다. 이 항목을 entry로 둔다.

7. URL 접두사와 entry의 URI template을 연결한 것을 URI template로 둔다.

8. entry의 명령을 command로 둔다.

9. URI template에 정의된 각 변수마다 하나의 entry를 갖는 map을 URL variables로 둔다. 여기서 항목 이름은 템플릿 변수 이름과 같고, 항목 값은 URI template을 URL의 path와 일치하도록 확장하는 데 필요한 변수 값이다.

10. command와 URL variables를 데이터로 하여 성공을 반환한다.

다음 엔드포인트 표는 각 엔드포인트 노드 명령에 대한 메서드와 URI 템플릿을 나열한다. 확장 명령은 이 표에 암묵적으로 추가된다.

오류는 WebDriver 프로토콜에서 4xx 또는 5xx 범위의 HTTP 상태를 가진 HTTP 응답과, 오류의 세부 정보를 포함하는 JSON 본문으로 표현된다. 본문은 JSON Object이며 "value"라는 이름의 필드를 갖고, 그 값은 세 개, 때로는 네 개의 필드를 지닌 객체이다.

• "error"는 오류 코드를 나타내는 문자열을 포함한다.
• "message"는 발생한 오류 종류에 대한 사람이 읽을 수 있는 설명을 담은 구현 정의 문자열을 포함한다.
• "stacktrace"는 오류가 발생한 시점의 활성 스택 프레임에 대한 스택 추적 보고서를 담은 구현 정의 문자열을 포함한다.
• 선택적으로 "data"는 오류 진단에 도움이 되는 추가 오류 데이터를 가진 JSON Object이다.

다음 표는 각 오류 코드, 그에 연관된 HTTP 상태, JSON error 코드, 그리고 오류에 대한 비규범적 설명을 나열한다. 특정 오류 코드에 대한 오류 응답 데이터는 해당 오류 코드에 대응하는 행의 HTTP Status 및 JSON Error Code 열의 값이다.

오류 데이터 딕셔너리는 문자열 키에서 JSON 직렬화 가능한 값으로의 매핑이며, 선택적으로 오류 객체에 포함될 수 있다.

이 절에서 정의한 용어를 사용하여, 다른 이들은 표준 프로토콜과 매끄럽게 통합되는 추가 명령을 정의할 수 있다. 이를 통해 공급업체는 자신의 사용자 에이전트에 특화된 기능을 노출할 수 있으며, 다른 웹 표준도 새로운 플랫폼 기능을 자동화하기 위한 명령을 정의할 수 있다.

이 방식으로 정의된 명령은 확장 명령이라고 하며, 다른 명령과 다르게 동작하지 않는다. 각각은 전용 HTTP 엔드포인트와 원격 엔드 단계 집합을 갖는다.

각 확장 명령에는 URI Template 문자열인 연관된 확장 명령 URI 템플릿이 있으며, 이는 명령이 수행하는 작업과 어느 정도 유사성을 가져야 한다. 이 값은 HTTP 메서드 및 확장 명령과 함께 엔드포인트 표에 추가되며, 따라서 다른 내장 명령과 같은 요청 라우팅 규칙을 따른다.

다른 구현과의 잠재적인 리소스 충돌을 피하기 위해, 공급업체별 확장 명령 URI 템플릿은 공급업체와 UA를 고유하게 식별하는 하나 이상의 경로 세그먼트로 시작해야 한다. 공급업체는 [CSS21]에 설명된 것처럼 추가 문자 없이 공급업체 접두사를 사용하는 것이 제안된다. 특히 공급업체 키워드에 관한 4.1.2.2절에서 설명된 대로, 이를 이 경로 요소의 이름으로 사용하고, 공급업체가 선택한 UA 식별자를 포함하는 것이 제안된다.

다른 명세는 추가 WebDriver 기능을 정의할 수 있다. 정의된 각 기능에는 ":"(콜론) 문자를 포함하지 않는 문자열인 기능 이름과, JSON 타입을 갖는 단일 인수 value를 받아 역직렬화된 기능 값을 감싼 성공 또는 오류를 반환하는 단계 집합인 추가 기능 역직렬화 알고리즘이 있어야 한다.

추가 WebDriver 기능은 현재 구현이 기능과 매칭되는지 결정하고 사용자에게 반환할 계산된 값을 제공하는 데 사용되는 단계 집합인 매칭된 기능 직렬화 알고리즘도 정의할 수 있다. 이 단계 집합은 단일 인수 value를 받는데, 이는 대응하는 추가 기능 역직렬화 알고리즘의 출력이며, 기능이 매칭되지 않음을 나타내기 위해 null을 반환하거나, 기능이 매칭되면 null이 아닌 JSON 직렬화 가능한 값을 반환한다.

다른 명세는 WebDriver 새 세션 알고리즘도 정의할 수 있다. 이는 새 세션이 생성된 직후, 그리고 새 세션 응답이 원격 엔드로 전송되기 전에 호출된다. 이러한 알고리즘은 설정될 WebDriver 세션을 나타내는 session과, 원격 엔드로 반환될 기능 객체인 capabilities를 인수로 호출된다. 그러한 알고리즘은 동일한 명세에서 정의한 추가 WebDriver 기능인 이름을 가진 기능 객체의 어떤 항목이든 수정할 수 있다.

원격 엔드는 구성 제공 또는 기타 공급업체별 요구 충족에 사용되는 추가 기능인 확장 기능도 도입할 수 있다. 확장 기능의 키는 구현별 네임스페이스를 나타내는 ":"(콜론) 문자를 포함해야 한다. 값은 임의의 JSON 타입일 수 있다.

확장 명령과 마찬가지로, 확장 기능 네임스페이스를 나타내는 데 사용되는 키는 [CSS21]에 나열된 공급업체 키워드를 기반으로 하며, 문자열에서 첫 번째 ":" 문자 앞에 오는 것이 제안된다.

프록시 구성 기능은 기본 기능 안에 중첩된 JSON Object이다. 구현은 추가 프록시 구성 옵션을 정의할 수 있지만, 아래 나열된 것들의 의미론을 변경해서는 안 된다.

scheme에 대한 host 및 선택적 port는 유효한 host로 정의되며, 선택적으로 콜론과 유효한 port가 뒤따를 수 있다. host는 자격 증명을 포함할 수 있다. port가 생략되고 scheme에 기본 port가 있으면, 이것이 암시된 port이다. 그렇지 않으면 port는 정의되지 않은 채로 둔다.

"direct"인 proxyType은 브라우저가 프록시를 전혀 사용해서는 안 됨을 나타낸다.

"system"인 proxyType은 브라우저가 기반 운영 체제에 구성된 다양한 프록시를 사용해야 함을 나타낸다.

"autodetect"인 proxyType은 사용할 프록시가 구현별 방식으로 감지되어야 함을 나타낸다.

인수 parameter를 프록시로 역직렬화하는 원격 엔드 단계는 다음과 같다.

1. parameter가 JSON Object가 아니면 오류 코드 invalid argument를 가진 오류를 반환한다.

2. proxy를 새 빈 프록시 구성 객체로 둔다.

3. parameter의 각 열거 가능한 own property에 대해 다음 하위 단계를 실행한다.

   1. key를 속성의 이름으로 둔다.

   2. value를 parameter에서 name이라는 이름의 속성을 가져온 결과로 둔다.

   3. 프록시 구성 표에 key에 대응하는 key가 없으면, 오류를 오류 코드 invalid argument와 함께 반환한다.

   4. value가 해당 key에 대한 valid values 중 하나가 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

   5. proxy에 대해 key 속성을 value로 설정한다.

4. proxy가 "proxyType"에 대한 own property를 갖지 않으면, 오류 코드 invalid argument를 가진 오류를 반환한다.

5. proxy에서 "proxyType"이라는 이름의 속성을 가져온 결과가 "pac"와 같고, proxy가 "proxyAutoconfigUrl"에 대한 own property를 갖지 않으면, 오류 코드 invalid argument를 가진 오류를 반환한다.

6. proxy가 "socksProxy"에 대한 own property를 갖지만 "socksVersion"에 대한 own property를 갖지 않으면, 오류 코드 invalid argument를 가진 오류를 반환한다.

7. proxy를 데이터로 하여 성공을 반환한다.

프록시 구성 객체는 자신의 own properties 중 프록시 구성의 키와 일치하는 각 속성이 해당 키의 유효성 기준을 충족하는 JSON Object이다.

parameters와 세션 구성 플래그 flags가 주어졌을 때 기능을 처리하기 위해, 엔드포인트 노드는 다음 단계를 수행해야 한다.

1. parameters에서 "capabilities" 속성을 가져온 결과를 capabilities request로 둔다.

   1. capabilities request가 JSON Object가 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

2. capabilities request에서 "alwaysMatch" 속성을 가져온 결과를 required capabilities로 둔다.

   1. required capabilities가 undefined이면, 값을 빈 JSON Object로 설정한다.

   2. required capabilities 및 flag를 인수로 하여 기능 검증을 시도한 결과를 required capabilities로 둔다.

3. capabilities request에서 "firstMatch" 속성을 가져온 결과를 all first match capabilities로 둔다.

   1. all first match capabilities가 undefined이면, 값을 빈 JSON Object 하나를 항목으로 갖는 List로 설정한다.

   2. all first match capabilities가 하나 이상의 항목을 가진 List가 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

4. validated first match capabilities를 빈 List로 둔다.

5. all first match capabilities의 색인 속성에 대응하는 각 first match capabilities에 대해:

   1. first match capabilities 및 flags를 인수로 하여 기능 검증을 시도한 결과를 validated capabilities로 둔다.

   2. validated capabilities를 validated first match capabilities에 추가한다.

6. merged capabilities를 빈 List로 둔다.

7. validated first match capabilities의 색인 속성에 대응하는 각 first match capabilities에 대해:

   1. required capabilities 및 first match capabilities를 인수로 하여 기능 병합을 시도한 결과를 merged로 둔다.

   2. merged를 merged capabilities에 추가한다.

8. merged capabilities의 색인 속성에 대응하는 각 capabilities에 대해:

   1. capabilities를 인수로 하여 기능 매칭을 시도한 결과를 matched capabilities로 둔다.

   2. matched capabilities가 null이 아니면, matched capabilities를 데이터로 하여 성공을 반환한다.

9. null을 데이터로 하여 성공을 반환한다.

인수 capabilities로 기능 검증이 요구될 때:

1. capabilities가 JSON Object가 아니면 오류 코드 invalid argument를 가진 오류를 반환한다.

2. result를 빈 JSON Object로 둔다.

3. capabilities의 각 열거 가능한 own property에 대해 다음 하위 단계를 실행한다.

   1. name을 속성의 이름으로 둔다.

   2. value를 capabilities에서 name이라는 이름의 속성을 가져온 결과로 둔다.

   3. 첫 번째로 매칭되는 조건의 하위 단계를 실행한다.

      value가 null이다

      deserialized가 null로 설정되도록 둔다.

      name이 "acceptInsecureCerts"와 같다

      value가 boolean이 아니면 오류 코드 invalid argument를 가진 오류를 반환한다. 그렇지 않으면 deserialized가 value로 설정되도록 둔다.

      name이 "browserName"와 같다

      name이 "browserVersion"와 같다

      name이 "platformName"와 같다

      value가 string이 아니면 오류 코드 invalid argument를 가진 오류를 반환한다. 그렇지 않으면 deserialized가 value로 설정되도록 둔다.

      name이 "pageLoadStrategy"와 같다

      value를 인수로 하여 페이지 로드 전략으로 역직렬화를 시도한 결과를 deserialized로 둔다.

      name이 "proxy"와 같다

      value를 인수로 하여 프록시로 역직렬화를 시도한 결과를 deserialized로 둔다.

      name이 "strictFileInteractability"와 같다

      value가 boolean이 아니면 오류 코드 invalid argument를 가진 오류를 반환한다. 그렇지 않으면 deserialized가 value로 설정되도록 둔다.

      name이 "timeouts"와 같다

      value로 시간 제한 구성으로 역직렬화를 시도한 결과를 deserialized로 둔다.

      name이 "unhandledPromptBehavior"와 같다

      value를 인수로 하여 처리되지 않은 프롬프트 동작으로 역직렬화를 시도한 결과를 deserialized로 둔다.

      name이 추가 WebDriver 기능의 이름이다

      name에 대응하는 확장 기능에 대해, value를 인수로 하여 추가 기능 역직렬화 알고리즘 실행을 시도한 결과를 deserialized로 둔다.

      name이 확장 기능의 키이다

      name이 구현에 알려져 있으면, value를 구현별 방식으로 역직렬화하기를 시도한 결과를 deserialized로 둔다. 그렇지 않으면 deserialized가 value로 설정되도록 둔다.

      원격 엔드가 엔드포인트 노드이다

      오류 코드 invalid argument를 가진 오류를 반환한다.

   4. deserialized가 null이 아니면, result에 대해 이름 name 및 값 deserialized로 속성을 설정한다.

4. result를 데이터로 하여 성공을 반환한다.

JSON Object 인수 primary와 secondary로 기능 병합을 할 때, 엔드포인트 노드는 다음 단계를 수행해야 한다.

1. result를 새 JSON Object로 둔다.

2. primary의 각 열거 가능한 own property에 대해 다음 하위 단계를 실행한다.

   1. name을 속성의 이름으로 둔다.

   2. value를 primary에서 name이라는 이름의 속성을 가져온 결과로 둔다.

   3. result에 대해 이름 name 및 값 value로 속성을 설정한다.

3. secondary가 undefined이면 result를 반환한다.

4. secondary의 각 열거 가능한 own property에 대해 다음 하위 단계를 실행한다.

   1. name을 속성의 이름으로 둔다.

   2. value를 secondary에서 name이라는 이름의 속성을 가져온 결과로 둔다.

   3. primary에서 name 속성을 가져온 결과를 primary value로 둔다.

   4. primary value가 undefined가 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

   5. result에 대해 이름 name 및 값 value로 속성을 설정한다.

5. result를 반환한다.

JSON Object capabilities와 세션 구성 플래그 flags가 주어졌을 때 기능 매칭을 할 때, 엔드포인트 노드는 다음 단계를 수행해야 한다.

1. matched capabilities를 다음 항목들을 가진 JSON Object로 둔다.

   "browserName"

   사용자 에이전트 이름을 ASCII 소문자화한 string.

   "browserVersion"

   사용자 에이전트 버전을 string으로 표현한 값.

   "platformName"

   현재 플랫폼 이름을 ASCII 소문자화한 string.

   "acceptInsecureCerts"

   초기값이 false인 Boolean으로, 세션이 신뢰할 수 없거나 자체 서명된 TLS 인증서를 탐색 시 암묵적으로 신뢰하지 않음을 나타낸다.

   "strictFileInteractability"

   초기값이 false인 Boolean으로, 상호작용 가능성 검사가 <input type=file>에 적용됨을 나타낸다.

   "setWindowRect"

   원격 엔드가 모든 크기 조정 및 위치 지정 명령을 지원하는지 여부를 나타내는 Boolean.

   "userAgent"

   기본 User-Agent 값을 포함하는 String.

2. flags가 "http"를 포함하면, 다음 항목을 matched capabilities에 추가한다.

   "strictFileInteractability"

   초기값이 false인 Boolean으로, 상호작용 가능성 검사가 <input type=file>에 적용됨을 나타낸다.

3. 선택적으로 확장 기능을 matched capabilities의 항목으로 추가한다. 이 값들은 생략될 수 있으며, 모든 확장 기능이 추가되어야 한다는 요구사항은 없다.

   참고

4. capabilities의 own properties에 대응하는 각 name 및 value에 대해:

   1. match value가 value와 같도록 둔다.

   2. 첫 번째로 매칭되는 name의 하위 단계를 실행한다.

      "browserName"

      value가 matched capabilities의 "browserName" 항목과 같은 문자열이 아니면, null을 데이터로 하여 성공을 반환한다.

      참고

      원격 엔드가 browserName을 올바르게 판단하기 위해 브라우저 프로세스를 시작해야 할 가능성이 있다. 이를 수행하기 전에는 가벼운 검사가 선호된다.

      "browserVersion"

      value를 matched capabilities의 "browserVersion" 항목과 구현 정의 비교 알고리즘으로 비교한다. 비교는 "<", "<=", ">", 및 ">=" 연산자를 사용하여 버전에 제약을 두는 value를 허용하기 위한 것이다.

      두 값이 매칭되지 않으면, null을 데이터로 하여 성공을 반환한다.

      참고

      각 사용자 에이전트는 사용자 에이전트 버전을 인코딩하는 서로 충돌하는 방식을 가질 가능성이 있고, 이러한 체계를 표준화하는 것은 이 표준의 범위를 벗어나므로 버전 비교는 구현 세부 사항으로 남겨져 있다.

      참고

      원격 엔드가 browserVersion을 올바르게 판단하기 위해 브라우저 프로세스를 시작해야 할 가능성이 있다. 이를 수행하기 전에는 가벼운 검사가 선호된다.

      "platformName"

      value가 matched capabilities의 "platformName" 항목과 같은 문자열이 아니면, null을 데이터로 하여 성공을 반환한다.

      참고

      다음 플랫폼 이름은 잘 이해된 의미론과 함께 널리 사용되고 있으며, 플랫폼 이름에 대한 기능 매칭 시, 잘 알려진 운영 체제에 대한 유효한 동의어로 이를 존중하면 가장 높은 상호운용성을 달성할 수 있다.

      키	시스템
      "linux"	Linux 커널을 기반으로 하는 모든 서버 또는 데스크톱 시스템.
      "mac"	Apple macOS의 모든 버전.
      "windows"	데스크톱 및 모바일 버전을 포함한 Microsoft Windows의 모든 버전.

      이 목록은 완전하지 않다.

      새 세션에서 기능을 반환할 때, 더 구체적인 platformName을 반환하는 것은 유효하며, 이를 통해 사용자는 WebDriver 구현이 실행 중인 운영 체제를 올바르게 식별할 수 있다.

      "acceptInsecureCerts"

      안전하지 않은 TLS 허용 플래그가 설정되어 있고 value와 같지 않으면, null을 데이터로 하여 성공을 반환한다.

      참고

      엔드포인트 노드가 안전하지 않은 TLS 인증서를 지원하지 않고 이것이 결국 매칭이 이루어지지 않는 이유라면, 이 정보를 로컬 엔드에 제공하는 것이 유용하다.

      "proxy"

      프록시 구성 있음 플래그가 설정되어 있거나, value에 정의된 프록시 구성이 엔드포인트 노드의 구현별 유효성 검사를 통과하지 못하는 경우, null을 데이터로 하여 성공을 반환한다.

      참고

      로컬 엔드는 해당 기능이 존중되고 구성된 프록시가 사용될 것으로 기대할 때만 이 기능을 보낼 것이다. 의도는 이것이 불가능한 경우 새 세션이 설정되지 않도록 하는 것이다.

      "unhandledPromptBehavior"

      value로 사용자 프롬프트 처리기 매칭 검사가 false이면, null을 데이터로 하여 성공을 반환한다.

      그 밖의 경우

      • name이 매칭된 기능 직렬화 알고리즘을 정의하는 추가 WebDriver 기능의 이름이면, value 및 flags를 인수로 하여 기능 name에 대한 매칭된 기능 직렬화 알고리즘을 실행한 결과를 match value로 둔다.

      • 그렇지 않고 name이 확장 기능의 키이면, name과 value에 대해 매칭하는 구현별 단계를 시도한 결과를 match value로 둔다. 매칭이 성공하지 않으면, null을 데이터로 하여 성공을 반환한다.

   3. match value가 null이 아니면, matched capabilities에 대해 이름 name 및 값 match value로 속성을 설정한다.

5. matched capabilities를 데이터로 하여 성공을 반환한다.

세션별 상태에 더해, 원격 엔드가 엔드포인트 노드인 경우에는 모든 세션에 걸쳐 전역적인 추가 상태도 가진다.

엔드포인트 노드는 신뢰할 수 없거나 자체 서명된 TLS 인증서를 신뢰된 것으로 취급할지 여부를 나타내는 연관된 안전하지 않은 TLS 허용 플래그를 가진다. 엔드포인트가 안전하지 않은 TLS 연결 허용을 지원하지 않는 경우 이 플래그의 기본값은 false이고, 그렇지 않으면 unset이다.

엔드포인트 노드는 프록시가 이미 구성되어 있는지 여부를 나타내는 연관된 프록시 구성이 있음 플래그를 가진다. 엔드포인트가 프록시 구성을 지원하지 않는 경우 이 플래그의 기본값은 true이고, 그렇지 않으면 false이다.

JSON Object capabilites와 세션 구성 플래그 flags가 주어졌을 때, 세션을 생성하려면:

1. session id를 UUID 생성의 결과로 둔다.

2. session을 세션 ID session id와, flags가 "http"를 포함하는 HTTP 플래그를 가진 새 세션으로 둔다.

3. proxy를 capabilities에서 "proxy" 속성을 가져온 결과로 두고, 처음 일치하는 문의 하위 단계를 실행한다:

   proxy가 프록시 구성 객체인 경우

   추출된 proxy 구성을 사용하여 사용자 에이전트 프록시를 설정하기 위한 구현 정의 단계를 수행한다. 정의된 프록시를 구성할 수 없으면 오류를 오류 코드 session not created와 함께 반환한다. 그렇지 않으면 프록시 구성이 있음 플래그를 true로 설정한다.

   그렇지 않으면

   capabilities의 속성을 이름 "proxy"와 새 JSON Object인 값으로 설정한다.

4. capabilites에 "acceptInsecureCerts"라는 이름의 속성이 있으면, 엔드포인트 노드의 안전하지 않은 TLS 허용 플래그를 capabilities에서 "acceptInsecureCerts"라는 이름의 속성을 가져온 결과로 설정한다.

5. user prompt handler capability를 capabilities에서 "unhandledPromptBehavior" 속성을 가져온 결과로 둔다.

6. user prompt handler capability가 undefined가 아니면, user prompt handler capability로 사용자 프롬프트 처리기를 갱신한다.

7. serialized user prompt handler를 사용자 프롬프트 처리기를 직렬화한 것으로 둔다.

8. capabilities에 이름 "unhandledPromptBehavior"와 값 serialized user prompt handler로 속성을 설정한다.

9. flags가 "http"를 contains하면:

   1. strategy를 capabilities에서 "pageLoadStrategy" 속성을 가져온 결과로 둔다.

      strategy가 문자열이면, 세션의 페이지 로딩 전략을 strategy로 설정한다. 그렇지 않으면, 페이지 로딩 전략을 normal로 설정하고 capabilities의 속성을 이름 "pageLoadStrategy" 및 값 "normal"로 설정한다.

   2. strictFileInteractability를 capabilities에서 "strictFileInteractability" 속성을 가져온 결과로 둔다. strictFileInteractability가 불리언이면, session의 엄격한 파일 상호작용 가능성을 strictFileInteractability로 설정한다.

   3. timeouts를 capabilities에서 "timeouts" 속성을 가져온 결과로 둔다. timeouts가 undefined가 아니면, session의 세션 타임아웃을 timeouts로 설정한다.

   4. capabilities에 이름 "timeouts"와 값 session의 세션 타임아웃으로 타임아웃 구성을 직렬화한 것을 설정한다.

10. capabilities 안의 모든 확장 capabilities를 구현 정의 방식으로 처리한다.

11. 외부 명세에 정의된 모든 WebDriver 새 세션 알고리즘을 인수 session, capabilities, 그리고 flags와 함께 실행한다.

12. session을 활성 세션에 추가한다.

13. flags가 "http"를 포함하면, session을 활성 HTTP 세션에 추가한다.

14. webdriver-active 플래그를 true로 설정한다.

session가 주어졌을 때 세션을 닫기 위해, 원격 엔드는 다음 단계를 수행해야 한다:

1. session의 HTTP 플래그가 설정되어 있으면, session을 활성 HTTP 세션에서 제거한다.

2. session을 활성 세션에서 제거한다.

3. 원격 엔드의 유형에 따라 다음 하위 단계를 수행한다:

   원격 엔드가 엔드포인트 노드인 경우

   1. 활성 세션 목록이 비어 있으면:

      1. webdriver-active 플래그를 false로 설정한다

      2. 사용자 프롬프트 처리기를 null로 설정한다.

      3. 안전하지 않은 TLS 허용 플래그를 unset한다.

      4. 프록시 구성이 있음 플래그를 그 기본값으로 재설정한다.

      5. 선택적으로, 모든 최상위 브라우징 컨텍스트를 언로드 프롬프트 없이 닫는다.

   원격 엔드가 중개 노드인 경우

   1. 연관된 세션을 닫는다. 이로 인해 오류가 발생하면, 오류를 반환하기 전에 이 알고리즘의 나머지를 완료한다.

4. 모든 구현별 정리 단계를 수행한다.

5. 위 단계 중 어느 단계에서든 오류가 발생했다면, 그 오류를 반환하고, 그렇지 않으면 데이터 null과 함께 success를 반환한다.

세션을 닫으면 연관된 브라우저 프로세스가 종료될 수도 있다. 모든 구현별 정리 단계는 응답이 클라이언트로 다시 전송된 후에 수행된다고 가정한다. 그래야 연결이 너무 이르게 닫히지 않는다.

New Session 명령은 엔드포인트 노드에 새 WebDriver 세션을 생성한다. 생성에 실패하면 session not created 오류가 반환된다.

원격 엔드가 중개 노드인 경우, 이는 기능 처리 알고리즘의 결과를 사용하여 새 세션 요청을 적절한 엔드포인트 노드로 라우팅할 수 있다. 중개 노드는 이 과정을 돕기 위한 확장 기능을 자유롭게 정의할 수 있다. 그러나 이러한 특정 기능은 엔드포인트 노드로 전달되어서는 안 된다.

중개 노드가 사용자 에이전트 기능과 무관한 추가 정보를 요구하는 경우, 이 정보는 요청된 기능의 일부가 아니라 최상위 매개변수로 전달하는 것이 권장된다. 중개 노드는 사용자 지정 최상위 매개변수, 즉 기능이 아닌 매개변수를 후속 원격 엔드 노드로 전달해야 한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. 구현이 엔드포인트 노드이고 활성 HTTP 세션 목록이 비어 있지 않거나, 또는 그 밖에 구현이 추가 세션을 시작할 수 없는 경우, 오류 코드 session not created를 가진 오류를 반환한다.

2. 원격 엔드가 중개 노드이면, 구현 정의 단계를 수행하여 오류를 오류 코드 session not created와 함께 반환하거나, 이 알고리즘의 나머지에 따라 원격 엔드가 반환하는 것과 동형인 데이터를 가진 success를 반환하게 한다. 오류가 반환되지 않으면, 중개 노드는 업스트림 노드에서 생성된 세션에 대한 참조를 연관된 세션으로 보존해야 하며, 그렇게 해서 이후 명령에서 명령을 이 연관된 세션으로 전달할 수 있게 한다.

   참고

   이를 수행하는 방식은 전적으로 구현에 달려 있지만, 일반적으로 sessionId와, 상류 원격 엔드의 URL 및 URL 접두사를 추적해야 할 것이다.

3. "http"를 포함하는 set을 flags로 둔다.

4. parameters와 flags로 기능 처리를 시도한 결과를 capabilities로 둔다.

5. capabilities가 null이면, 오류 코드 session not created를 가진 오류를 반환한다.

6. capabilities 및 flags로 세션을 생성한 결과를 session으로 둔다.

7. 다음으로 초기화된 JSON Object를 body로 둔다.

   "sessionId"

   session의 세션 ID.

   "capabilities"

   capabilities

8. session의 현재 최상위 브라우징 컨텍스트를 엔드포인트 노드의 최상위 브라우징 컨텍스트 중 하나로 설정한다. 이때 system focus를 가진 최상위 브라우징 컨텍스트를 선호하고, 그렇지 않으면 visibility state가 visible인 임의의 최상위 브라우징 컨텍스트를 선호한다.

   참고

   WebDriver 구현은 일반적으로 완전히 새로운 브라우저 인스턴스를 시작하지만, 이 명세에는 그러한 요구사항이 없다(또는 WebDriver가 웹 브라우저만 자동화하는 데 사용되어야 한다는 요구사항도 없다). 구현은 예를 들어 현재 포커스를 가진 창을 선택함으로써 기존 브라우저 인스턴스를 사용하도록 선택할 수 있다.

9. 요청 큐를 새 queue로 설정한다.

10. body를 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session이 활성 HTTP 세션이면, session으로 세션 닫기를 시도한다.

2. null을 데이터로 하여 성공을 반환한다.

구현은 선택적으로 본문의 일부로 추가 메타 정보를 포함할 수 있지만, 최상위 속성 ready와 message는 예약되어 있으며 덮어써서는 안 된다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. 다음 속성을 가진 새 JSON Object를 body로 둔다.

   "ready"

   원격 엔드의 준비 상태.

   "message"

   원격 엔드의 준비 상태를 설명하는 구현 정의 문자열.

2. body를 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. timeouts를 타임아웃 구성을 직렬화한 것으로 두되, 세션의 타임아웃 구성을 사용한다.

2. 데이터 timeouts와 함께 success를 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. parameters로 시간 제한 구성으로 역직렬화를 시도한 결과를 timeouts로 둔다.

2. session의 시간 제한 구성을 timeouts로 설정한다.

3. null을 데이터로 하여 성공을 반환한다.

원격 엔드의 안전하지 않은 TLS 허용 플래그가 true이면, 일반적으로 사용자 에이전트가 중단하고 보안 경고를 표시하게 만드는 인증서 오류가 요청된 주소로의 내비게이션을 방해해서는 안 된다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. parameters에서 "url"이라는 이름의 속성을 가져온 결과를 URL로 둔다.

2. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

3. URL이 absolute URL이 아니거나 fragment가 있는 absolute URL이 아니거나 local scheme이 아니면, 오류를 오류 코드 invalid argument와 함께 반환한다.

4. session으로 모든 사용자 프롬프트 처리를 시도한다.

5. timeout을 세션의 세션 타임아웃 페이지 로드 타임아웃으로 둔다.

6. current URL을 session의 현재 최상위 브라우징 컨텍스트의 활성 문서의 URL로 둔다.

7. current URL과 URL이 같은 absolute URL을 갖지 않고 timeout이 null이 아니면:

   1. timer를 새 타이머로 설정한다.

   2. timer와 timeout으로 타이머를 시작한다.

8. 이 단계를 실행하되, timer의 시간 제한 발생 플래그가 설정되면 abort한다.

   1. session의 현재 최상위 브라우징 컨텍스트를 URL로 탐색한다.

   2. URL이 file을 제외하고 special이며, current URL과 URL이 같은 absolute URL을 갖지 않으면:

      1. session 및 timer로 탐색 완료 대기를 시도한다.

      2. 탐색 후 검사 실행을 시도한다.

   3. session과 현재 최상위 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

   4. session의 현재 최상위 브라우징 컨텍스트가 time 1초 이하의 refresh state pragma directive를 포함하는 동안, 다음 단계를 실행한다.

      1. current URL을 session의 현재 최상위 브라우징 컨텍스트의 활성 문서의 URL로 설정한다.

      2. refresh timeout이 경과하고 session의 현재 최상위 브라우징 컨텍스트의 새 탐색이 시작될 때까지 기다린다.

      3. URL을 session의 현재 최상위 브라우징 컨텍스트의 활성 문서의 진행 중인 탐색의 목적지 URL로 설정한다.

      4. URL이 file을 제외하고 special이며, current URL과 URL이 같은 absolute URL을 갖지 않으면:

         1. session 및 timer로 탐색 완료 대기를 시도한다.

         2. 탐색 후 검사 실행을 시도한다.

9. 중단된 경우, 오류를 오류 코드 timeout과 함께 반환한다.

10. null을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. URL을 session의 현재 최상위 브라우징 컨텍스트의 활성 문서의 URL을 직렬화한 것으로 둔다.

4. URL을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. timeout을 session의 세션 시간 제한 페이지 로드 시간 제한으로 둔다.

4. timer를 새 타이머로 둔다.

5. timeout이 null이 아니면:

   1. timer와 timeout으로 타이머를 시작한다.

6. session의 현재 브라우징 컨텍스트에 대해 delta로 기록을 순회 –1을 수행한다.

7. 이전 단계의 완료 결과 pageHide event firing이 발생하면, pageShow event가 발생할 때까지 또는 timer의 시간 제한 발생 플래그가 설정될 때까지, 둘 중 먼저 발생하는 것을 기다린다.

8. timer의 시간 제한 발생 플래그가 설정되면:

   1. 모든 사용자 프롬프트를 처리한다.

   2. 오류를 오류 코드 timeout과 함께 반환한다.

9. null을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. timeout을 session의 세션 시간 제한 페이지 로드 시간 제한으로 둔다.

4. timer를 새 타이머로 둔다.

5. timeout이 null이 아니면:

   1. timer와 timeout으로 타이머를 시작한다.

6. session의 현재 브라우징 컨텍스트에 대해 delta로 기록을 순회 1을 수행한다.

7. 이전 단계의 완료 결과 pageHide event firing이 발생하면, pageShow event가 발생할 때까지 또는 timer의 시간 제한 발생 플래그가 설정될 때까지, 둘 중 먼저 발생하는 것을 기다린다.

8. timer의 시간 제한 발생 플래그가 설정되면:

   1. 모든 사용자 프롬프트를 처리한다.

   2. 오류를 오류 코드 timeout과 함께 반환한다.

9. null을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. session의 현재 최상위 브라우징 컨텍스트의 활성 문서에 대해 overridden reload를 시작한다.

4. URL이 file을 제외하고 special이면:

   1. session으로 탐색 완료 대기를 시도한다.

   2. 탐색 후 검사 실행을 시도한다.

5. session 및 session의현재 최상위 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

6. null을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. title을 session의 현재 최상위 브라우징 컨텍스트의 활성 문서의 title로 둔다.

4. title을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session의 현재 최상위 브라우징 컨텍스트와 연관된 창 핸들을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

2. session으로 모든 사용자 프롬프트 처리를 시도한다.

3. session의 현재 최상위 브라우징 컨텍스트를 닫는다.

4. 더 이상 열려 있는 최상위 브라우징 컨텍스트가 없으면, 세션 닫기를 시도한다.

5. session, URL variables 및 parameters로 창 핸들들 가져오기 명령의 원격 엔드 단계를 실행한 결과를 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. handle을 parameters에서 "handle" 속성을 가져온 결과로 둔다.

2. handle이 undefined이면, 오류 코드 invalid argument를 가진 오류를 반환한다.

3. 다른 최상위 브라우징 컨텍스트에 포커스하는 것을 막는 활성 사용자 프롬프트가 있으면, 오류 코드 unexpected alert open을 가진 오류를 반환한다.

4. handle이 어떤 최상위 브라우징 컨텍스트의 연관된 창 핸들과 같으면, context를 그 브라우징 컨텍스트로 두고, session 및 context로 현재 최상위 브라우징 컨텍스트를 설정한다.

   그렇지 않으면, 오류 코드 no such window를 가진 오류를 반환한다.

5. OS 수준 포커스를 변경하지 않고, 사용자가 상호작용을 위해 session의 현재 브라우징 컨텍스트를 선택한 결과로 생길 구현별 상태를 갱신한다.

6. null을 데이터로 하여 성공을 반환한다.

창 핸들이 반환되는 순서는 임의적이다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. handles를 List로 둔다.

2. 원격 엔드의 각 최상위 브라우징 컨텍스트에 대해, 연관된 창 핸들을 handles에 push한다.

3. handles를 데이터로 하여 성공을 반환한다.

새 최상위 브라우징 컨텍스트를 생성한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. 구현이 새 최상위 브라우징 컨텍스트 생성을 지원하지 않으면, 오류 코드 unsupported operation을 가진 오류를 반환한다.

2. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류를 오류 코드 no such window와 함께 반환한다.

3. session으로 모든 사용자 프롬프트 처리를 시도한다.

4. type hint를 parameters에서 "type" 속성을 가져온 결과로 둔다.

5. URL을 "about:blank"로, target을 빈 문자열로, features를 "noopener"로 설정하고 사용자 에이전트가 새 브라우징 컨텍스트를 생성하도록 구성하여 window open 단계를 실행함으로써 새 최상위 브라우징 컨텍스트를 생성한다. 이는 생성된 브라우징 컨텍스트에 대한 포커싱 단계를 호출하지 않고 수행되어야 한다. type hint가 "tab" 값을 가지고, 구현이 같은 OS 창 안의 여러 브라우징 컨텍스트를 지원하면, 새 브라우징 컨텍스트는 session의 현재 브라우징 컨텍스트와 OS 창을 공유하는 것이 좋다. type hint가 "window"이고 구현이 별도 OS 창의 여러 브라우징 컨텍스트를 지원하면, 생성된 브라우징 컨텍스트는 새 OS 창에 있는 것이 좋다. 그 밖의 모든 경우 브라우징 컨텍스트가 사용자에게 표시되는 방식의 세부 사항은 구현 정의이다.

6. handle을 새로 생성된 창의 연관된 창 핸들로 둔다.

7. 새로 생성된 창이 session의 현재 브라우징 컨텍스트와 OS 수준 창을 공유하면 type을 "tab"으로, 그렇지 않으면 "window"로 둔다.

8. result를 다음으로 초기화된 새 JSON Object로 둔다.

   "handle"

   handle의 값.

   "type"

   type의 값.

9. result를 데이터로 하여 성공을 반환한다.

1. id를 parameters에서 "id" 속성을 가져온 결과로 둔다.

2. id가 null, Number 객체, 또는 웹 요소를 나타내는 Object가 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

3. 첫 번째로 매칭되는 조건의 하위 단계를 실행한다.

   id가 null이다

   1. session의 현재 최상위 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류 코드 no such window를 가진 오류를 반환한다.

   2. session으로 모든 사용자 프롬프트 처리를 시도한다.

   3. session 및 session의 현재 최상위 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

   id가 Number 객체이다

   1. id가 0보다 작거나 2¹⁶ – 1보다 크면, 오류 코드 invalid argument를 가진 오류를 반환한다.

   2. session의 현재 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류 코드 no such window를 가진 오류를 반환한다.

   3. session으로 모든 사용자 프롬프트 처리를 시도한다.

   4. window를 session의 현재 브라우징 컨텍스트의 활성 문서의 연관된 window로 둔다.

   5. id가 window의 지원되는 속성 인덱스가 아니면, 오류 코드 no such frame를 가진 오류를 반환한다.

   6. child window를 window.[[GetOwnProperty]] (id)를 호출하여 얻은 WindowProxy 객체로 둔다.

   7. session 및 child window의 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

   id가 웹 요소를 나타낸다

   1. session의 현재 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류 코드 no such window를 가진 오류를 반환한다.

   2. session으로 모든 사용자 프롬프트 처리를 시도한다.

   3. element를 session 및 id로 알려진 요소 가져오기를 시도한 결과로 둔다.

   4. element가 frame 또는 iframe 요소가 아니면, 오류 코드 no such frame를 가진 오류를 반환한다.

   5. session 및 element의 content navigable의 활성 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

4. OS 수준 포커스를 변경하지 않고, 사용자가 상호작용을 위해 session의 현재 브라우징 컨텍스트를 선택한 결과로 생길 구현별 상태를 갱신한다.

5. null을 데이터로 하여 성공을 반환한다.

session, URL variables 및 parameters가 주어졌을 때의 원격 엔드 단계는 다음과 같다.

1. session의 현재 브라우징 컨텍스트가 이미 최상위 브라우징 컨텍스트이면:

   1. session의 현재 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류 코드 no such window를 가진 오류를 반환한다.

   2. null을 데이터로 하여 성공을 반환한다.

2. session의 현재 부모 브라우징 컨텍스트가 더 이상 열려 있지 않음이면, 오류 코드 no such window를 가진 오류를 반환한다.

3. session으로 모든 사용자 프롬프트 처리를 시도한다.

4. 세션의 현재 부모 브라우징 컨텍스트가 null이 아니면, session 및 현재 부모 브라우징 컨텍스트로 현재 브라우징 컨텍스트를 설정한다.

5. OS 수준 포커스를 변경하지 않고, 사용자가 상호작용을 위해 session의 현재 브라우징 컨텍스트를 선택한 결과로 생길 구현별 상태를 갱신한다.

6. null을 데이터로 하여 성공을 반환한다.

WebDriver는 session의 현재 최상위 브라우징 컨텍스트를 포함하는 운영 체제 창과 상호작용하기 위한 명령을 제공한다. 서로 다른 운영 체제의 창 관리자는 서로 다른 능력을 제공하므로, 이 절의 모든 명령이 모든 원격 엔드에서 지원될 수 있는 것은 아니다. 이러한 명령에 대한 지원 여부는 창 크기 조정/위치 지정 기능으로 결정된다. 명령이 지원되지 않는 경우, unsupported operation 오류가 반환된다.

최상위 브라우징 컨텍스트에는 그 OS 위젯 창이 어떤 표시 상태에 있는지를 설명하는 연관된 창 상태가 있다. 이는 다음 상태 중 하나일 수 있다.

어떤 이유로든 최상위 브라우징 컨텍스트의 OS 창이 창 상태 중 어느 하나에 들어갈 수 없거나, 이 개념이 현재 시스템에 적용되지 않는 경우, 기본 상태는 normal이어야 한다.

WindowProxy window에 대한 WindowRect 객체는 다음 속성으로 초기화된 Object이다.

"x"

window의 screenX 속성.

"y"

window의 screenY 속성.

"width"

windows의 outerWidth 속성.

"height"

window의 outerHeight 속성.

연관된 최상위 브라우징 컨텍스트를 가진 운영 체제 수준 창이 주어졌을 때, 창을 최대화하려면, 운영 체제 수준 창을 최대화된 창 상태로 전환하는 구현별 단계를 실행한다. 창 관리자가 창 크기 조정을 지원하지만 창 최대화 개념을 갖지 않는 경우, 창 크기는 현재 화면에 대해 창 관리자가 허용하는 최대 가용 크기까지 증가되어야 한다. 창이 전환을 완료했을 때, 또는 구현 정의 시간 제한 안에 반환한다.

연관된 최상위 브라우징 컨텍스트를 가진 운영 체제 수준 창이 주어졌을 때, 창을 아이콘화하려면, 운영 체제 수준 창을 최소화된 창 상태로 전환하는 구현별 단계를 실행한다. 최상위 브라우징 컨텍스트의 활성 문서의 visibility state가 hidden 상태에 도달하거나, 작업 시간이 초과될 때까지 이 작업에서 반환하지 않는다.

연관된 최상위 브라우징 컨텍스트를 가진 운영 체제 수준 창이 주어졌을 때, 창을 복원하려면, 창을 보이는 화면으로 복원하거나 숨김 해제하는 구현별 단계를 실행한다. 최상위 브라우징 컨텍스트의 활성 문서의 visibility state가 visible 상태에 도달하거나, 작업 시간이 초과될 때까지 이 작업에서 반환하지 않는다.

요소가 포인터 동작을 사용하여 상호작용될 수 있는지를 판단하기 위해, WebDriver는 히트 테스팅을 수행하여 상호작용이 요청된 요소에 도달할 수 있는지를 찾는다.

상호작용 가능 요소는 요소 중 포인터 상호작용 가능하거나 키보드 상호작용 가능한 요소이다.

포인터 상호작용 가능 요소는 렌더링된 스크롤바의 크기를 제외하고 뷰포트 안에 있는 그 사각형의 중앙점에서 발견되는 페인트 순서로 정의되는 첫 번째 요소로 정의된다.

키보드 상호작용 가능 요소는 포커스 가능 영역을 가지는 임의의 요소, body 요소, 또는 문서 요소이다.

요소의 뷰 안 중앙점은 요소의 첫 번째 DOMRect인 getClientRects()와 초기 뷰포트 사이의 교차 영역인 사각형의 원점 위치이다. 이는 다음과 같이 계산할 수 있다.

1. rectangle을 element에서 getClientRects()를 호출하여 반환된 DOMRect 컬렉션의 첫 번째 객체로 둔다.

2. left를 max(0, min(x 좌표, x 좌표 + 너비 치수))로 둔다.

3. right를 min(innerWidth, max(x 좌표, x 좌표 + 너비 치수))로 둔다.

4. top을 max(0, min(y 좌표, y 좌표 + 높이 치수))로 둔다.

5. bottom을 min(innerHeight, max(y 좌표, y 좌표 + 높이 치수))로 둔다.

6. x를 floor((left + right) ÷ 2.0)로 둔다.

7. y를 floor((top + bottom) ÷ 2.0)로 둔다.

8. (x, y) 쌍을 반환한다.

요소 element는 다음 단계가 true를 반환하면 비활성화됨이다.

1. element가 option 요소이거나 element가 optgroup 요소이면:

   1. element의 각 포함 조상 ancestor에 대해:

      1. ancestor가 optgroup 요소이거나 ancestor가 select 요소이고, ancestor가 실제로 비활성화되어 있으면, true를 반환한다.

   2. false를 반환한다.

2. element가 실제로 비활성화되어 있는지를 반환한다.

요소는 그 자체의 포인터 상호작용 가능 페인트 트리의 구성원인 경우, 그 포인터 이벤트가 비활성화되어 있지 않다고 가정하면 뷰 안에 있음이다.

요소는 그 중앙점에서의 포인터 상호작용 가능 페인트 트리가 비어 있거나, 이 트리의 첫 번째 요소가 그 자신에 대한 포함 후손이 아니면 가려져 있음이다.

요소 element의 포인터 상호작용 가능 페인트 트리는 다음 방식으로 생성된다:

1. element가 session의 현재 브라우징 컨텍스트의 활성 문서와 같은 트리에 있지 않으면, 빈 시퀀스를 반환한다.

2. rectangles를 element에서 getClientRects()를 호출하여 반환된 DOMRect 시퀀스로 둔다.

3. rectangles의 길이가 0이면, 빈 시퀀스를 반환한다.

4. center point를 element의 뷰 내 중심점으로 둔다.

5. 좌표 center point가 주어졌을 때 점으로부터의 요소들을 반환한다.

섀도 루트는 섀도 루트를 식별하는 데 사용되는 추상화로, 이것이 프로토콜을 통해 원격 엔드와 로컬 엔드 사이에서 전달될 때 사용된다.

섀도 루트 식별자는 문자열 상수 "shadow-6066-11e4-a52e-4f735466cecf"이다.

ECMAScript Object는 섀도 루트 식별자 own property를 가지면 섀도 루트를 나타낸다.

session 및 reference가 주어졌을 때 알려진 섀도 루트를 가져오려면:

1. session, session의 현재 브라우징 컨텍스트, 및 reference로 노드 참조가 알려져 있지 않으면, 오류 코드 no such shadow root를 가진 오류를 반환한다.
2. node를 session, session의 현재 브라우징 컨텍스트, 및 reference로 노드를 가져온 결과로 둔다.
3. node가 null이 아니고 node가 ShadowRoot를 구현하지 않으면, 오류 코드 no such shadow root를 가진 오류를 반환한다.
4. node가 null이거나 node가 분리되어 있으면, 오류 코드 detached shadow root를 가진 오류를 반환한다.
5. node를 데이터로 하여 성공을 반환한다.

session 및 shadow root가 주어졌을 때 섀도 루트 참조를 가져오거나 생성하려면:

1. Assert: element는 ShadowRoot를 구현한다.
2. session, session의 현재 브라우징 컨텍스트, 및 element로 노드 참조를 가져오거나 생성하기를 시도한 결과를 반환한다.

session 및 shadow root에 대한 섀도 루트 참조 객체는 다음과 같이 주어진다.

1. identifier를 섀도 루트 식별자로 둔다.

2. reference를 session 및 shadow root로 섀도 루트 참조를 가져오거나 생성한 결과로 둔다.

3. 이름이 identifier이고 값이 reference인 프로퍼티로 초기화된 JSON Object를 반환한다.

섀도 루트를 나타내는 JSON Object object로 섀도 루트를 역직렬화해야 하는 경우:

1. object에 own property인 섀도 루트 식별자가 없으면, 오류 코드 invalid argument를 가진 오류를 반환한다.

2. reference를 object에서 섀도 루트 식별자 속성을 가져온 결과로 둔다.

3. reference가 String이 아니면, 오류 코드 invalid argument를 가진 오류를 반환한다.

4. shadow를 session 및 reference로 알려진 섀도 루트 가져오기를 시도한 결과로 둔다.

5. shadow를 데이터로 하여 성공을 반환한다.

섀도 루트는 그 노드 문서가 활성 문서가 아니거나, 그 host로 가리켜지는 요소 노드가 stale이면 분리되어 있다.

요소 찾기, 요소들 찾기, 요소에서 요소 찾기, 요소에서 요소들 찾기, 섀도 루트에서 요소 찾기, 및 섀도 루트에서 요소들 찾기 명령은 개별 요소 및 요소 컬렉션의 조회를 허용한다. 요소 검색은 제공된 선택자의 표현식과 일치하는 문서 노드의 전위 순회를 사용하여 수행된다.

session, start node, using 및 value가 주어졌을 때 찾기가 필요한 경우, 원격 엔드는 다음 단계를 실행해야 한다.

1. location strategy를 using과 같게 둔다.

2. selector를 value와 같게 둔다.

3. timeout을 session의 세션 시간 제한의 암시적 대기 시간 제한으로 둔다.

4. timer를 새 타이머로 둔다.

5. timeout이 null이 아니면:

   1. timer와 timeout으로 타이머를 시작한다.

6. elements returned를 빈 List로 둔다.

7. elements returned가 비어 있고 timer의 timeout fired flag가 설정되어 있지 않은 동안:

   1. elements returned를 start node 및 selector를 인수로 하여 관련 요소 위치 전략을 호출하기를 시도한 결과로 설정한다.

   2. 요소 위치 전략 실행 중 DOMException, SyntaxError, XPathException, 또는 기타 오류가 발생하면 invalid selector 오류를 반환한다.

8. result를 빈 List로 둔다.

9. elements returned 안의 각 element에 대해, session 및 element에 대한 웹 요소 참조 객체를 result에 추가한다.

10. result를 데이터로 하여 성공을 반환한다.

session 및 element가 주어졌을 때 절대 위치를 계산하려면:

1. rect를 getBoundingClientRect()를 호출하여 반환된 값으로 둔다.

2. window를 session의 현재 최상위 브라우징 컨텍스트의 연관된 window로 둔다.

3. x를 (window의 scrollX + rect의 x 좌표)로 둔다.

4. y를 (window의 scrollY + rect의 y 좌표)로 둔다.

5. (x, y) 쌍을 반환한다.

Node node가 Node other와 같은 트리에 있지 않은지 확인하려면, 다음 하위 단계를 실행한다.

1. node의 노드 문서가 other의 노드 문서가 아니면, true를 반환한다.

2. node의 compareDocumentPosition()를 other를 인수로 호출한 결과가 DOCUMENT_POSITION_DISCONNECTED (1)이면 true를 반환하고, 그렇지 않으면 false를 반환한다.

element의 컨테이너는 다음과 같다.

유효한 요소 컨텍스트 안의 option 요소

유효한 요소 컨텍스트 안의 optgroup 요소

element의 요소 컨텍스트이며, 이는 다음으로 결정된다.

1. datalist parent를 element에서 역순으로 트리를 순회하여 도달한 첫 번째 datalist 요소로 두고, 트리의 루트에 도달하면 undefined로 둔다.

2. select parent를 element에서 역순으로 트리를 순회하여 도달한 첫 번째 select 요소로 두고, 트리의 루트에 도달하면 undefined로 둔다.

3. datalist parent가 undefined이면, 요소 컨텍스트는 select parent이다. 그렇지 않으면, 요소 컨텍스트는 datalist parent이다.

유효하지 않은 요소 컨텍스트 안의 option 요소

요소는 컨테이너를 가지지 않는다.

그 밖의 경우

컨테이너는 요소 자체이다.

요소 상호작용 명령은 폼 컨트롤을 조작하기 위한 고수준 명령 집합을 제공한다. 동작과 달리, 이 명령들은 암묵적으로 요소를 뷰 안으로 스크롤하고 그것이 상호작용 가능 요소인지 검사한다.

일부 재설정 가능 요소는 자체 지우기 알고리즘을 정의한다. 이와 연관된 재설정 알고리즘과 달리, 이러한 알고리즘의 일부로 폼 컨트롤에 이루어진 변경은 사용자에 의해 발생한 변경으로 간주된다 (따라서 예컨대 input 이벤트가 발생한다). 자체 지우기 알고리즘을 정의하지 않은 요소에 대해 지우기 알고리즘이 호출되면, 대신 그 재설정 알고리즘이 호출되어야 한다.

input 요소에 대한 지우기 알고리즘은 dirty value 플래그 및 dirty checkedness 플래그를 false로 되돌리고, 요소의 값을 빈 문자열로 설정하며, 요소가 checked 콘텐츠 속성을 가지면 요소의 checkedness를 true로, 그렇지 않으면 false로 설정하고, 선택된 파일 목록을 비우며, 그 다음 type 속성의 현재 상태가 하나를 정의하는 경우에만 값 정제 알고리즘을 호출하는 것이다.

textarea 요소에 대한 지우기 알고리즘은 dirty value 플래그를 false로 되돌리고, 요소의 raw value를 빈 문자열로 설정하는 것이다.

output 요소에 대한 지우기 알고리즘은 요소의 값 모드 플래그를 default로 설정한 뒤, 요소의 textContent IDL 속성을 빈 문자열로 설정하는 것이다(따라서 요소의 자식 노드를 지운다).