Skip to content

Commit c405b93

Browse files
committed
Capitalize User Agent throughout spec
1 parent 6759001 commit c405b93

File tree

1 file changed

+55
-55
lines changed

1 file changed

+55
-55
lines changed

index.src.html

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -309,9 +309,9 @@
309309
[=Enqueues a control message=] to configure the audio decoder for decoding
310310
chunks as described by |config|.
311311

312-
NOTE: This method will trigger a {{NotSupportedError}} if the user agent
312+
NOTE: This method will trigger a {{NotSupportedError}} if the User Agent
313313
does not support |config|. Authors should first check support by calling
314-
{{AudioDecoder/isConfigSupported()}} with |config|. User agents are not
314+
{{AudioDecoder/isConfigSupported()}} with |config|. User Agents are not
315315
required to support any particular codec type or configuration.
316316

317317
When invoked, run these steps:
@@ -418,10 +418,10 @@
418418
<dt><dfn method for=AudioDecoder>isConfigSupported(config)</dfn></dt>
419419
<dd>
420420
Returns a promise indicating whether the provided |config| is supported by
421-
the user agent.
421+
the User Agent.
422422

423423
NOTE: The returned {{AudioDecoderSupport}} {{AudioDecoderSupport/config}}
424-
will contain only the dictionary members that user agent recognized.
424+
will contain only the dictionary members that User Agent recognized.
425425
Unrecognized dictionary members will be ignored. Authors may detect
426426
unrecognized dictionary members by comparing
427427
{{AudioDecoderSupport/config}} to their provided |config|.
@@ -576,9 +576,9 @@
576576
[=Enqueues a control message=] to configure the video decoder for decoding
577577
chunks as described by |config|.
578578

579-
NOTE: This method will trigger a {{NotSupportedError}} if the user agent
579+
NOTE: This method will trigger a {{NotSupportedError}} if the User Agent
580580
does not support |config|. Authors should first check support by calling
581-
{{VideoDecoder/isConfigSupported()}} with |config|. User agents are not
581+
{{VideoDecoder/isConfigSupported()}} with |config|. User Agents are not
582582
required to support any particular codec type or configuration.
583583

584584
When invoked, run these steps:
@@ -691,10 +691,10 @@
691691
<dt><dfn method for=VideoDecoder>isConfigSupported(config)</dfn></dt>
692692
<dd>
693693
Returns a promise indicating whether the provided |config| is supported by
694-
the user agent.
694+
the User Agent.
695695

696696
NOTE: The returned {{VideoDecoderSupport}} {{VideoDecoderSupport/config}}
697-
will contain only the dictionary members that user agent recognized.
697+
will contain only the dictionary members that User Agent recognized.
698698
Unrecognized dictionary members will be ignored. Authors may detect
699699
unrecognized dictionary members by comparing
700700
{{VideoDecoderSupport/config}} to their provided |config|.
@@ -861,9 +861,9 @@
861861
[=Enqueues a control message=] to configure the audio encoder for
862862
decoding chunks as described by |config|.
863863

864-
NOTE: This method will trigger a {{NotSupportedError}} if the user agent
864+
NOTE: This method will trigger a {{NotSupportedError}} if the User Agent
865865
does not support |config|. Authors should first check support by calling
866-
{{AudioEncoder/isConfigSupported()}} with |config|. User agents are not
866+
{{AudioEncoder/isConfigSupported()}} with |config|. User Agents are not
867867
required to support any particular codec type or configuration.
868868

869869
When invoked, run these steps:
@@ -962,10 +962,10 @@
962962
<dt><dfn method for=AudioEncoder>isConfigSupported(config)</dfn></dt>
963963
<dd>
964964
Returns a promise indicating whether the provided |config| is supported by
965-
the user agent.
965+
the User Agent.
966966

967967
NOTE: The returned {{AudioEncoderSupport}} {{AudioEncoderSupport/config}}
968-
will contain only the dictionary members that user agent recognized.
968+
will contain only the dictionary members that User Agent recognized.
969969
Unrecognized dictionary members will be ignored. Authors may detect
970970
unrecognized dictionary members by comparing
971971
{{AudioEncoderSupport/config}} to their provided |config|.
@@ -1020,7 +1020,7 @@
10201020
|outputConfig|.{{AudioDecoderConfig/numberOfChannels}}.
10211021
4. Assign |outputConfig|.{{AudioDecoderConfig/description}} with a
10221022
sequence of codec specific bytes as determined by the
1023-
{{AudioEncoder/[[codec implementation]]}}. The user agent must
1023+
{{AudioEncoder/[[codec implementation]]}}. The User Agent must
10241024
ensure that the provided description could be used to
10251025
correctly decode output.
10261026

@@ -1177,9 +1177,9 @@
11771177
[=Enqueues a control message=] to configure the video encoder for
11781178
decoding chunks as described by |config|.
11791179

1180-
NOTE: This method will trigger a {{NotSupportedError}} if the user agent
1180+
NOTE: This method will trigger a {{NotSupportedError}} if the User Agent
11811181
does not support |config|. Authors should first check support by calling
1182-
{{VideoEncoder/isConfigSupported()}} with |config|. User agents are not
1182+
{{VideoEncoder/isConfigSupported()}} with |config|. User Agents are not
11831183
required to support any particular codec type or configuration.
11841184

11851185
When invoked, run these steps:
@@ -1279,10 +1279,10 @@
12791279
<dt><dfn method for=VideoEncoder>isConfigSupported(config)</dfn></dt>
12801280
<dd>
12811281
Returns a promise indicating whether the provided |config| is supported by
1282-
the user agent.
1282+
the User Agent.
12831283

12841284
NOTE: The returned {{VideoEncoderSupport}} {{VideoEncoderSupport/config}}
1285-
will contain only the dictionary members that user agent recognized.
1285+
will contain only the dictionary members that User Agent recognized.
12861286
Unrecognized dictionary members will be ignored. Authors may detect
12871287
unrecognized dictionary members by comparing
12881288
{{VideoEncoderSupport/config}} to their provided |config|.
@@ -1341,7 +1341,7 @@
13411341
5. Assign `encoderConfig.displayHeight` to
13421342
`outputConfig.displayHeight`.
13431343
6. Assign the remaining keys of `outputConfig` as determined by
1344-
{{VideoEncoder/[[codec implementation]]}}. The user agent
1344+
{{VideoEncoder/[[codec implementation]]}}. The User Agent
13451345
must ensure that the configuration is completely described
13461346
such that |outputConfig| could be used to correctly decode
13471347
|output|.
@@ -1431,7 +1431,7 @@
14311431
<dfn>Check Configuration Support</dfn> (with |config|) {#config-support}
14321432
------------------------------------------------------------------------
14331433
Run these steps:
1434-
1. If the user agent can provide a <a>codec</a> to support all entries of the
1434+
1. If the User Agent can provide a <a>codec</a> to support all entries of the
14351435
|config|, including applicable default values for keys that are not
14361436
included, return `true`.
14371437

@@ -1441,7 +1441,7 @@
14411441

14421442
NOTE: Support for a given configuration may change dynamically if the
14431443
hardware is altered (e.g. external GPU unplugged) or if required
1444-
hardware resources are exhausted. User agents should describe support on
1444+
hardware resources are exhausted. User Agents should describe support on
14451445
a best-effort basis given the resources that are available at the time
14461446
of the query.
14471447

@@ -1450,7 +1450,7 @@
14501450
<dfn>Clone Configuration</dfn> (with |config|) {#clone-config}
14511451
--------------------------------------------------------------
14521452

1453-
NOTE: This algorithm will copy only the dictionary members that the user agent
1453+
NOTE: This algorithm will copy only the dictionary members that the User Agent
14541454
recognizes as part of the dictionary type.
14551455

14561456
Run these steps:
@@ -1479,11 +1479,11 @@
14791479
<dt><dfn dict-member for=AudioDecoderSupport>supported</dfn></dt>
14801480
<dd>
14811481
A boolean indicating the whether the corresponding
1482-
{{AudioDecoderSupport/config}} is supported by the user agent.
1482+
{{AudioDecoderSupport/config}} is supported by the User Agent.
14831483
</dd>
14841484
<dt><dfn dict-member for=AudioDecoderSupport>config</dfn></dt>
14851485
<dd>
1486-
An {{AudioDecoderConfig}} used by the user agent in determining the value of
1486+
An {{AudioDecoderConfig}} used by the User Agent in determining the value of
14871487
{{AudioDecoderSupport/supported}}.
14881488
</dd>
14891489
</dl>
@@ -1500,11 +1500,11 @@
15001500
<dt><dfn dict-member for=VideoDecoderSupport>supported</dfn></dt>
15011501
<dd>
15021502
A boolean indicating the whether the corresponding
1503-
{{VideoDecoderSupport/config}} is supported by the user agent.
1503+
{{VideoDecoderSupport/config}} is supported by the User Agent.
15041504
</dd>
15051505
<dt><dfn dict-member for=VideoDecoderSupport>config</dfn></dt>
15061506
<dd>
1507-
A {{VideoDecoderConfig}} used by the user agent in determining the value of
1507+
A {{VideoDecoderConfig}} used by the User Agent in determining the value of
15081508
{{VideoDecoderSupport/supported}}.
15091509
</dd>
15101510
</dl>
@@ -1521,11 +1521,11 @@
15211521
<dt><dfn dict-member for=AudioEncoderSupport>supported</dfn></dt>
15221522
<dd>
15231523
A boolean indicating the whether the corresponding
1524-
{{AudioEncoderSupport/config}} is supported by the user agent.
1524+
{{AudioEncoderSupport/config}} is supported by the User Agent.
15251525
</dd>
15261526
<dt><dfn dict-member for=AudioEncoderSupport>config</dfn></dt>
15271527
<dd>
1528-
An {{AudioEncoderConfig}} used by the user agent in determining the value of
1528+
An {{AudioEncoderConfig}} used by the User Agent in determining the value of
15291529
{{AudioEncoderSupport/supported}}.
15301530
</dd>
15311531
</dl>
@@ -1542,11 +1542,11 @@
15421542
<dt><dfn dict-member for=VideoEncoderSupport>supported</dfn></dt>
15431543
<dd>
15441544
A boolean indicating the whether the corresponding
1545-
{{VideoEncoderSupport/config}} is supported by the user agent.
1545+
{{VideoEncoderSupport/config}} is supported by the User Agent.
15461546
</dd>
15471547
<dt><dfn dict-member for=VideoEncoderSupport>config</dfn></dt>
15481548
<dd>
1549-
A {{VideoEncoderConfig}} used by the user agent in determining the value of
1549+
A {{VideoEncoderConfig}} used by the User Agent in determining the value of
15501550
{{VideoEncoderSupport/supported}}.
15511551
</dd>
15521552
</dl>
@@ -1851,7 +1851,7 @@
18511851

18521852
<div class='note'>
18531853
NOTE: Most authors will be best served by using the default of
1854-
{{HardwareAcceleration/allow}}. This gives the user agent flexibility to
1854+
{{HardwareAcceleration/allow}}. This gives the User Agent flexibility to
18551855
optimize based on its knowledge of the system and configuration. A common
18561856
strategy will be to prioritize hardware acceleration at higher resolutions
18571857
with a fallback to software codecs if hardware acceleration fails.
@@ -1886,20 +1886,20 @@
18861886
<dl>
18871887
<dt><dfn enum-value for=HardwareAcceleration>allow</dfn></dt>
18881888
<dd>
1889-
Indicates that the user agent may use hardware acceleration if it is
1889+
Indicates that the User Agent may use hardware acceleration if it is
18901890
available and compatible with other aspects of the codec configuration.
18911891
</dd>
18921892
<dt><dfn enum-value for=HardwareAcceleration>deny</dfn></dt>
18931893
<dd>
1894-
Indicates that the user agent must not use hardware acceleration.
1894+
Indicates that the User Agent must not use hardware acceleration.
18951895

18961896
NOTE: This will cause the configuration to be unsupported on platforms where
18971897
an unaccelerated codec is unavailable or is incompatible with other aspects
18981898
of the codec configuration.
18991899
</dd>
19001900
<dt><dfn enum-value for=HardwareAcceleration>require</dfn></dt>
19011901
<dd>
1902-
Indicates that the user agent must use hardware acceleration.
1902+
Indicates that the User Agent must use hardware acceleration.
19031903

19041904
NOTE: This will cause the configuration to be unsupported on platforms where
19051905
an accelerated codec is unavailable or is incompatible with other aspects of
@@ -1917,17 +1917,17 @@
19171917
</xmp>
19181918

19191919
: <dfn enum-value for=LatencyMode>quality</dfn>
1920-
:: Indicates that the user agent should optimize for encoding quality. In
1920+
:: Indicates that the User Agent should optimize for encoding quality. In
19211921
this mode:
1922-
* User agents may increase encoding latency to improve quality.
1923-
* User agents must not drop frames to achieve the target
1922+
* User Agents may increase encoding latency to improve quality.
1923+
* User Agents must not drop frames to achieve the target
19241924
{{VideoEncoderConfig/bitrate}}.
19251925

19261926
: <dfn enum-value for=LatencyMode>realtime</dfn>
1927-
:: Indicates that the user agent should optimize for low latency. In this
1927+
:: Indicates that the User Agent should optimize for low latency. In this
19281928
mode:
1929-
* User agents may sacrifice quality to improve latency.
1930-
* User agents may drop frames to achieve the target
1929+
* User Agents may sacrifice quality to improve latency.
1930+
* User Agents may drop frames to achieve the target
19311931
{{VideoEncoderConfig/bitrate}}.
19321932

19331933
Configuration Equivalence{#config-equivalence}
@@ -1949,7 +1949,7 @@
19491949
<dt><dfn dict-member for=VideoEncoderEncodeOptions>keyFrame</dfn></dt>
19501950
<dd>
19511951
A value of `true` indicates that the given frame MUST be encoded as a key
1952-
frame. A value of `false` indicates that the user agent has flexibility to
1952+
frame. A value of `false` indicates that the User Agent has flexibility to
19531953
decide whether the frame will be encoded as a [=key frame=].
19541954
</dd>
19551955
</dl>
@@ -2175,7 +2175,7 @@
21752175
referenced by a `[[resource reference]]`.
21762176

21772177
NOTE: When a [=media resource=] is no longer referenced by a
2178-
`[[resource reference]]`, the resource may be destroyed. User agents are
2178+
`[[resource reference]]`, the resource may be destroyed. User Agents are
21792179
encouraged to destroy such resources quickly to reduce memory pressure and
21802180
facilitate resource reuse.
21812181

@@ -2816,7 +2816,7 @@
28162816
{{PixelFormat}} and reference them in the steps above. See
28172817
[#165](https://github.com/w3c/webcodecs/issues/165).
28182818

2819-
NOTE: The user agent may choose to allocate resource with a larger coded
2819+
NOTE: The User Agent may choose to allocate resource with a larger coded
28202820
size and plane strides to improve memory alignment. Increases will be
28212821
reflected by {{VideoFrame/codedWidth}} and {{VideoFrame/codedHeight}}.
28222822

@@ -2837,7 +2837,7 @@
28372837
the byte positioned at |dataOffset| and stopping after
28382838
{{PlaneInit/stride}} bytes have been copied.
28392839

2840-
NOTE: The user agent may use {{VideoFramePlaneInit/visibleRect}}
2840+
NOTE: The User Agent may use {{VideoFramePlaneInit/visibleRect}}
28412841
to copy only the visible rectangle. It may also reposition
28422842
the visible rectangle within |resource|. The final position
28432843
will be reflected by {{VideoFrame/visibleRect}}.
@@ -3421,7 +3421,7 @@
34213421
specify how the plane is laid out in the destination {{BufferSource}}}.
34223422
Alternatively, callers can inspect {{VideoFrame/copyTo()}}'s returned sequence
34233423
of {{PlaneLayout}}s to learn the the offset and stride for planes as decided by
3424-
the user agent.
3424+
the User Agent.
34253425

34263426
<xmp class='idl'>
34273427
dictionary PlaneLayout {
@@ -3554,9 +3554,9 @@
35543554
ImageDecoder(init)
35553555
</dfn>
35563556
:: NOTE: Calling {{ImageDecoder/decode()}} on the constructed {{ImageDecoder}}
3557-
will trigger a {{NotSupportedError}} if the user agent does not support
3557+
will trigger a {{NotSupportedError}} if the User Agent does not support
35583558
|type|. Authors should first check support by calling
3559-
{{ImageDecoder/isTypeSupported()}} with |type|. User agents are not
3559+
{{ImageDecoder/isTypeSupported()}} with |type|. User Agents are not
35603560
required to support any particular type.
35613561

35623562
When invoked, run these steps:
@@ -3661,7 +3661,7 @@
36613661
steps:
36623662
1. Wait for {{ImageDecoder/[[tracks established]]}} to become `true`.
36633663
2. If |options|.{{ImageDecodeOptions/completeFramesOnly}} is `false` and
3664-
the image is a [=Progressive Image=] for which the user agent supports
3664+
the image is a [=Progressive Image=] for which the User Agent supports
36653665
progressive decoding, run the [=Decode Progressive Frame=] algorithm with |options|.{{ImageDecodeOptions/frameIndex}} and |promise|.
36663666
3. Otherwise, run the [=Decode Complete Frame=] algorithm with
36673667
|options|.{{ImageDecodeOptions/frameIndex}} and |promise|.
@@ -3681,7 +3681,7 @@
36813681

36823682
: <dfn method for=ImageDecoder>isTypeSupported(type)</dfn>
36833683
:: Returns a promise indicating whether the provided config is supported by the
3684-
user agent.
3684+
User Agent.
36853685

36863686
When invoked, run these steps:
36873687
1. If |type| is not a [=valid image MIME type=], return a {{Promise}}
@@ -3962,7 +3962,7 @@
39623962
{{EncodingError}} {{DOMException}}.
39633963

39643964
: <dfn for=ImageDecoder>Check Type Support</dfn> (with |type|)
3965-
:: 1. If the user agent can provide a codec to support decoding |type|, return
3965+
:: 1. If the User Agent can provide a codec to support decoding |type|, return
39663966
`true`.
39673967
2. Otherwise, return `false`.
39683968

@@ -4077,7 +4077,7 @@
40774077
previous call, until finally the full-detail image is produced.
40784078

40794079
If {{ImageDecodeOptions/completeFramesOnly}} is assigned `true`, or if the
4080-
image is not a [=Progressive Image=], or if the user agent does not support
4080+
image is not a [=Progressive Image=], or if the User Agent does not support
40814081
progressive decoding for the given image type, calls to
40824082
{{ImageDecoder/decode()}} will only resolve once the full detail image is
40834083
decoded.
@@ -4292,9 +4292,9 @@
42924292
affords attackers the ability to invoke sequences of control methods that were
42934293
not previously possible via the higher level APIs.
42944294

4295-
User agents should mitigate this risk by extensively fuzzing their
4295+
User Agents should mitigate this risk by extensively fuzzing their
42964296
implementation with random inputs and control method invocations. Additionally,
4297-
user agents are encouraged to isolate their underlying codecs in processes with
4297+
User Agents are encouraged to isolate their underlying codecs in processes with
42984298
restricted privileges (sandbox) as a barrier against successful exploits being
42994299
able to read user data.
43004300

@@ -4328,7 +4328,7 @@
43284328
expose some additional information in the form of low level codec features.
43294329

43304330
A codec feature profile alone is unlikely to be uniquely identifying. Underlying
4331-
codecs are often implemented entirely in software (be it part of the user agent
4331+
codecs are often implemented entirely in software (be it part of the User Agent
43324332
binary or part of the operating system), such that all users who run that
43334333
software will have a common set of capabilities. Additionally, underlying codecs
43344334
are often implemented with hardware acceleration, but such hardware is mass
@@ -4340,8 +4340,8 @@
43404340

43414341
Segmenting groups of users by codec feature profile still amounts to a bit of
43424342
entropy that can be combined with other metrics to uniquely identify a user.
4343-
User agents may partially mitigate this by returning an error whenever a site
4344-
attempts to exhaustively probe for codec capabilities. Additionally, user agents
4343+
User Agents may partially mitigate this by returning an error whenever a site
4344+
attempts to exhaustively probe for codec capabilities. Additionally, User Agents
43454345
may implement a "privacy budget", which depletes as authors use WebCodecs and
43464346
other identifying APIs. Upon exhaustion of the privacy budget, codec
43474347
capabilities could be reduced to a common baseline or prompt for user approval.

0 commit comments

Comments
 (0)