@@ -117,7 +117,7 @@ <h3>Compatibility</h3>
117
117
118
118
< p >
119
119
This specification is derived from the popular
120
- < a href =http ://www.seleniumhq.org> Selenium WebDriver</ a > browser automation framework.
120
+ < a href =https ://www.seleniumhq.org/ > Selenium WebDriver</ a > browser automation framework.
121
121
Selenium is a long-lived project,
122
122
and due to its age and breadth of use
123
123
it has a wide range of expected functionality.
@@ -177,43 +177,49 @@ <h2>Terminology</h2>
177
177
produces the largest integer, closest to positive infinity,
178
178
that is not larger than < var > value</ var > .
179
179
180
- < p > A < dfn data-lt =uuid > Universally Unique IDentifier (UUID)</ dfn > is
181
- a 128 bits long URN that requires no central registration process. [[!RFC4122]].
182
- < dfn > Generating a UUID</ dfn > means Creating a
183
- < a > UUID</ a > From Truly Random or Pseudo-Random Numbers [[!RFC4122]],
184
- and converting it to the string representation [[!RFC4122]].
180
+ < p >
181
+ A < dfn data-lt =uuid > Universally Unique IDentifier (UUID)</ dfn > is
182
+ a 128 bits long URN that requires no central registration process. [[!RFC4122]].
183
+ < dfn > Generating a UUID</ dfn > means Creating a
184
+ < a > UUID</ a > From Truly Random or Pseudo-Random Numbers [[!RFC4122]],
185
+ and converting it to the string representation [[!RFC4122]].
185
186
186
- < p > The < dfn data-lt ="Unix timestamp "> Unix Epoch</ dfn >
187
- is a value that approximates the number of seconds
188
- that have elapsed since the Epoch,
189
- as described by The Open Group Base Specifications Issue 7
190
- < a href =http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_15 > section 4.15</ a > (IEEE Std 1003.1).
187
+ < p >
188
+ The < dfn data-lt ="Unix timestamp "> Unix Epoch</ dfn >
189
+ is a value that approximates the number of seconds
190
+ that have elapsed since the Epoch,
191
+ as described by The Open Group Base Specifications Issue 7
192
+ < a href =https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_15 > section 4.15</ a > (IEEE Std 1003.1).
191
193
192
- < p > An < dfn > integer</ dfn > is a < a > Number</ a > that is unchanged
193
- under the < a > ToInteger</ a > operation.
194
+ < p >
195
+ An < dfn > integer</ dfn > is a < a > Number</ a > that is unchanged
196
+ under the < a > ToInteger</ a > operation.
194
197
195
- < p > The < dfn > initial value</ dfn > of an ECMAScript property
196
- is the value defined by the platform for that property,
197
- i.e. the value it would have in the absence of any shadowing by content script.
198
+ < p >
199
+ The < dfn > initial value</ dfn > of an ECMAScript property
200
+ is the value defined by the platform for that property,
201
+ i.e. the value it would have in the absence of any shadowing by content script.
198
202
199
203
<!--
200
- ‘Chrome’ definition is borrowed
201
- from Web Security Context: User Interface Guidelines:
202
- https://www.w3.org/TR/wsc-ui/#def-chrome
204
+ ‘Chrome’ definition is borrowed
205
+ from Web Security Context: User Interface Guidelines:
206
+ https://www.w3.org/TR/wsc-ui/#def-chrome
203
207
-->
204
- < p > The < dfn > browser chrome</ dfn > is a non-normative term
205
- to refer to the representation through which the user
206
- interacts with the user agent itself,
207
- as distinct from the accessed web content.
208
- Examples of < dfn data-lt ="browser chrome element "> browser chrome elements</ dfn >
209
- include, but are not limited to,
210
- toolbars (such as the bookmark toolbar),
211
- menus (such as the file or context menu),
212
- buttons (such as the back and forward buttons),
213
- door hangers (such as security and certificate indicators),
214
- and decorations (such as operating system widget borders).
208
+ < p >
209
+ The < dfn > browser chrome</ dfn > is a non-normative term
210
+ to refer to the representation through which the user
211
+ interacts with the user agent itself,
212
+ as distinct from the accessed web content.
213
+ Examples of < dfn data-lt ="browser chrome element "> browser chrome elements</ dfn >
214
+ include, but are not limited to,
215
+ toolbars (such as the bookmark toolbar),
216
+ menus (such as the file or context menu),
217
+ buttons (such as the back and forward buttons),
218
+ door hangers (such as security and certificate indicators),
219
+ and decorations (such as operating system widget borders).
215
220
</ section > <!-- /Terminology -->
216
221
222
+
217
223
< section data-dfn-for =NavigatorAutomationInformation data-link-for =NavigatorAutomationInformation >
218
224
< h2 > Interface</ h2 >
219
225
@@ -1353,7 +1359,7 @@ <h2>Extensions</h2>
1353
1359
// browser specific configuration
1354
1360
"<prefix>:browserOptions": {
1355
1361
"binary": "/usr/bin/browser-binary",
1356
- "args": ["--start-page=http ://example.com"],
1362
+ "args": ["--start-page=https ://example.com"],
1357
1363
}
1358
1364
}
1359
1365
}
@@ -8998,7 +9004,7 @@ <h2>Element displayedness</h2>
8998
9004
8999
9005
< p > The approach recommended to implementors to ascertain
9000
9006
an < a > element</ a > 's visibility was originally developed by
9001
- the < a href =" http ://www.seleniumhq.org" > Selenium</ a > project, and is
9007
+ the < a href =https ://www.seleniumhq.org/ > Selenium</ a > project, and is
9002
9008
based on crude approximations about an < a > element</ a > 's nature and
9003
9009
relationship in the tree. An < a > element</ a > is in general to be
9004
9010
considered visible if any part of it is drawn on the canvas within
@@ -9037,7 +9043,7 @@ <h2>Acknowledgements</h2>
9037
9043
<!-- ~~~ run sort(1) on this ~~~ -->
9038
9044
9039
9045
<!-- Aleksey Chemakin --> Aleksey Chemakin,
9040
- <!-- Andreas Tolfsen --> < a href =https://sny.no > Andreas Tolfsen</ a > ,
9046
+ <!-- Andreas Tolfsen --> < a href =https://sny.no/ > Andreas Tolfsen</ a > ,
9041
9047
<!-- Andrey Botalov --> Andrey Botalov,
9042
9048
<!-- Clayton Martin --> Clayton Martin,
9043
9049
<!-- Daniel Wagner-Hall --> Daniel Wagner-Hall,
@@ -9052,7 +9058,7 @@ <h2>Acknowledgements</h2>
9052
9058
<!-- Jim Evans --> Jim Evans,
9053
9059
<!-- John Jansen --> John Jansen,
9054
9060
<!-- Luke Inman-Semerau --> Luke Inman-Semerau,
9055
- <!-- Maja Frydrychowicz --> < a href =http ://www.erranderr.com/> Maja Frydrychowicz</ a > ,
9061
+ <!-- Maja Frydrychowicz --> < a href =https ://www.erranderr.com/> Maja Frydrychowicz</ a > ,
9056
9062
<!-- Malini Das --> Malini Das,
9057
9063
<!-- Marc Fisher --> Marc Fisher,
9058
9064
<!-- Mike Pennisi --> Mike Pennisi,
@@ -9197,52 +9203,52 @@ <h2>Index</h2>
9197
9203
<!-- Iterable --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-iterable-interface > Iterable</ a > </ dfn >
9198
9204
<!-- Completion --> < li > < dfn > < a href ="https://tc39.github.io/ecma262/#sec-completion-record-specification-type "> Completion</ a > </ dfn >
9199
9205
<!-- CreateResolvingFunctions --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-createresolvingfunctions > CreateResolvingFunctions</ a > </ dfn >
9200
- <!-- Directive prologue --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-14.1> Directive prologue</ a > </ dfn >
9201
- <!-- Early error --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-16> Early error</ a > </ dfn >
9202
- <!-- Function --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.24> Function</ a > </ dfn >
9203
- <!-- FunctionBody --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-13> FunctionBody</ a > </ dfn >
9206
+ <!-- Directive prologue --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-14.1> Directive prologue</ a > </ dfn >
9207
+ <!-- Early error --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-16> Early error</ a > </ dfn >
9208
+ <!-- Function --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.24> Function</ a > </ dfn >
9209
+ <!-- FunctionBody --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-13> FunctionBody</ a > </ dfn >
9204
9210
<!-- FunctionCreate --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-functioncreate > FunctionCreate</ a > </ dfn >
9205
9211
<!-- Get --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-get-o-p > Get</ a > </ dfn >
9206
- <!-- Global environment --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-10.2.3> Global environment</ a > </ dfn >
9212
+ <!-- Global environment --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-10.2.3> Global environment</ a > </ dfn >
9207
9213
<!-- IsCallable --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-iscallable > IsCallable</ a > </ dfn >
9208
- <!-- Own property --> < li > < dfn data-lt ="own properties "> < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.30> Own property</ a > </ dfn >
9214
+ <!-- Own property --> < li > < dfn data-lt ="own properties "> < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.30> Own property</ a > </ dfn >
9209
9215
<!-- Promise --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-promise-constructor > Promise</ a > </ dfn >
9210
9216
<!-- PromiseResolve --> < li > < dfn > < a href =https://tc39.github.io/ecma262/#sec-promise-resolve > PromiseResolve</ a > </ dfn >
9211
9217
<!-- Type --> < li > < dfn data-lt ="ecmascript type " data-lt-noDefault > < a href =https://tc39.github.io/ecma262/#sec-ecmascript-data-types-and-values > Type</ a > </ dfn >
9212
- <!-- Use strict directive --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-14.1> Use strict directive</ a > </ dfn >
9213
- <!-- parseFloat --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-15.1.2.3> parseFloat</ a > </ dfn >
9218
+ <!-- Use strict directive --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-14.1> Use strict directive</ a > </ dfn >
9219
+ <!-- parseFloat --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-15.1.2.3> parseFloat</ a > </ dfn >
9214
9220
<!-- realm --> < li > < dfn > < a href ="https://tc39.github.io/ecma262/#sec-code-realms "> realm</ a > </ dfn >
9215
9221
</ ul >
9216
9222
9217
9223
< dd > This specification also presumes that you are able to call
9218
9224
some of the < dfn data-lt ="internal method "> < a href =https://www.ecma-international.org/ecma-262/5.1/#sec-8.6.2 > internal methods</ a > </ dfn >
9219
9225
from the ECMAScript Language Specification:
9220
9226
< ul >
9221
- <!-- Call --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-13.2.1> Call</ a > </ dfn >
9222
- <!-- Class --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-8.6.2> [[\Class]]</ a > </ dfn >
9223
- <!-- GetOwnProperty --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.1> [[\GetOwnProperty]]</ a > </ dfn >
9224
- <!-- GetProperty --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.2> [[\GetProperty]]</ a > </ dfn >
9225
- <!-- Index of --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-15.5.4.7> Index of</ a > </ dfn >
9226
- <!-- Put --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.5> [[\Put]]</ a > </ dfn >
9227
- <!-- Substring --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-15.5.4.15> Substring</ a > </ dfn >
9227
+ <!-- Call --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-13.2.1> Call</ a > </ dfn >
9228
+ <!-- Class --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-8.6.2> [[\Class]]</ a > </ dfn >
9229
+ <!-- GetOwnProperty --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.1> [[\GetOwnProperty]]</ a > </ dfn >
9230
+ <!-- GetProperty --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.2> [[\GetProperty]]</ a > </ dfn >
9231
+ <!-- Index of --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-15.5.4.7> Index of</ a > </ dfn >
9232
+ <!-- Put --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-8.12.5> [[\Put]]</ a > </ dfn >
9233
+ <!-- Substring --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-15.5.4.15> Substring</ a > </ dfn >
9228
9234
</ ul >
9229
9235
9230
9236
< dd > The ECMAScript Language Specification also defines the following
9231
9237
types, values, and operations that are used throughout this
9232
9238
specification:
9233
9239
< ul >
9234
- <!-- Array --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-11.1.4> Array</ a > </ dfn >
9235
- <!-- Boolean type --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.14> Boolean</ a > </ dfn > type
9236
- <!-- List --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-8.8> List</ a > </ dfn >
9237
- <!-- Max Safe Integer --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/6.0/#sec-number.max_safe_integer> maximum safe integer</ a > </ dfn >
9238
- <!-- null --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.11> Null</ a > </ dfn >
9239
- <!-- Number --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.19> Number</ a > </ dfn >
9240
- <!-- Object --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.2.1> Object</ a > </ dfn >
9241
- <!-- Parse --> < li > < dfn > < a href =" http ://www.ecma-international.org/ecma-262/5.1/#sec-15.12.2" > [[\Parse]]</ a > </ dfn >
9242
- <!-- String --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.18> String</ a > </ dfn >
9243
- <!-- Stringify --> < li > < dfn > < a href =" http ://www.ecma-international.org/ecma-262/5.1/#sec-15.12.3" > [[\Stringify]]</ a > </ dfn >
9244
- <!-- ToInteger --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/6.0/#sec-tointeger> ToInteger</ a > </ dfn >
9245
- <!-- undefined --> < li > < dfn > < a href =http ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.9> Undefined</ a > </ dfn >
9240
+ <!-- Array --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-11.1.4> Array</ a > </ dfn >
9241
+ <!-- Boolean type --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.14> Boolean</ a > </ dfn > type
9242
+ <!-- List --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-8.8> List</ a > </ dfn >
9243
+ <!-- Max Safe Integer --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/6.0/#sec-number.max_safe_integer> maximum safe integer</ a > </ dfn >
9244
+ <!-- null --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.11> Null</ a > </ dfn >
9245
+ <!-- Number --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.19> Number</ a > </ dfn >
9246
+ <!-- Object --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.2.1> Object</ a > </ dfn >
9247
+ <!-- Parse --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-15.12.2> [[\Parse]]</ a > </ dfn >
9248
+ <!-- String --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.18> String</ a > </ dfn >
9249
+ <!-- Stringify --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-15.12.3> [[\Stringify]]</ a > </ dfn >
9250
+ <!-- ToInteger --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/6.0/#sec-tointeger> ToInteger</ a > </ dfn >
9251
+ <!-- undefined --> < li > < dfn > < a href =https ://www.ecma-international.org/ecma-262/5.1/#sec-4.3.9> Undefined</ a > </ dfn >
9246
9252
</ ul >
9247
9253
9248
9254
< dt > Fetch
@@ -9461,7 +9467,7 @@ <h2>Index</h2>
9461
9467
< dd > < p > The following terms are defined in
9462
9468
the Hypertext Transfer Protocol (HTTP) Status Code Registry:
9463
9469
< ul >
9464
- <!-- Status code registry --> < li > < dfn > < a href =http ://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml> Status code registry</ a > </ dfn >
9470
+ <!-- Status code registry --> < li > < dfn > < a href =https ://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml> Status code registry</ a > </ dfn >
9465
9471
</ ul >
9466
9472
9467
9473
< dd > The following terms are defined in
@@ -9491,11 +9497,11 @@ <h2>Index</h2>
9491
9497
9492
9498
< dt > Selenium
9493
9499
< dd > The following functions are defined within
9494
- the < a href =" http ://www.seleniumhq.org" > Selenium</ a > project, at
9500
+ the < a href =https ://www.seleniumhq.org/ > Selenium</ a > project, at
9495
9501
revision < code > 1721e627e3b5ab90a06e82df1b088a33a8d11c20</ code > .
9496
9502
< ul >
9497
- <!-- bot.dom.getVisibleText --> < li > < dfn > < a href =" https://github.com/SeleniumHQ/selenium/blob/e09e28f016c9f53196cf68d6f71991c5af4a35d4/javascript/atoms/dom.js#L981 " > < code > bot.dom.getVisibleText</ code > </ a > </ dfn >
9498
- <!-- bot.dom.isShown --> < li > < dfn > < a href =" https://github.com/SeleniumHQ/selenium/blob/e09e28f016c9f53196cf68d6f71991c5af4a35d4/javascript/atoms/dom.js#L437 " > < code > bot.dom.isShown</ code > </ a > </ dfn >
9503
+ <!-- bot.dom.getVisibleText --> < li > < dfn > < a href =https://github.com/SeleniumHQ/selenium/blob/e09e28f016c9f53196cf68d6f71991c5af4a35d4/javascript/atoms/dom.js#L981 > < code > bot.dom.getVisibleText</ code > </ a > </ dfn >
9504
+ <!-- bot.dom.isShown --> < li > < dfn > < a href =https://github.com/SeleniumHQ/selenium/blob/e09e28f016c9f53196cf68d6f71991c5af4a35d4/javascript/atoms/dom.js#L437 > < code > bot.dom.isShown</ code > </ a > </ dfn >
9499
9505
</ ul >
9500
9506
9501
9507
< dt > Styling
@@ -9580,20 +9586,20 @@ <h2>Index</h2>
9580
9586
< dt > Unicode
9581
9587
< dd > The following terms are defined in the standard: [[!Unicode]]
9582
9588
< ul >
9583
- <!-- Code point --> < li > < dfn data-lt ="unicode code point "> < a href =http ://www.unicode.org/versions/Unicode9.0.0/ch03.pdf#G2212> Code Point</ a > </ dfn >
9584
- <!-- Extended grapheme cluster --> < li > < dfn data-lt ="grapheme cluster "> < a href =http ://www.unicode.org/versions/Unicode9.0.0/ch03.pdf#G2213> Extended grapheme cluster</ a > </ dfn >
9589
+ <!-- Code point --> < li > < dfn data-lt ="unicode code point "> < a href =https ://www.unicode.org/versions/Unicode9.0.0/ch03.pdf#G2212> Code Point</ a > </ dfn >
9590
+ <!-- Extended grapheme cluster --> < li > < dfn data-lt ="grapheme cluster "> < a href =https ://www.unicode.org/versions/Unicode9.0.0/ch03.pdf#G2213> Extended grapheme cluster</ a > </ dfn >
9585
9591
</ ul >
9586
9592
9587
9593
< dt > Unicode Standard Annex #29
9588
9594
< dd > The following terms are defined in the standard: [[!UAX29]]
9589
9595
< ul >
9590
- <!-- Breaking text into extended grapheme clusters --> < li > < dfn data-lt ="breaking text into extended grapheme clusters "> < a href =http ://unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries> Grapheme cluster boundaries</ a > </ dfn >
9596
+ <!-- Breaking text into extended grapheme clusters --> < li > < dfn data-lt ="breaking text into extended grapheme clusters "> < a href =https ://unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries> Grapheme cluster boundaries</ a > </ dfn >
9591
9597
</ ul >
9592
9598
9593
9599
< dt > Unicode Standard Annex #44
9594
9600
< dd > The following terms are defined in the standard: [[!UAX44]]
9595
9601
< ul >
9596
- <!-- Unicode character property --> < li > < dfn > < a href =http ://unicode.org/reports/tr44/#Properties> Unicode character property</ a > </ dfn >
9602
+ <!-- Unicode character property --> < li > < dfn > < a href =https ://unicode.org/reports/tr44/#Properties> Unicode character property</ a > </ dfn >
9597
9603
</ ul >
9598
9604
9599
9605
< dt > URLs
0 commit comments