@@ -529,7 +529,7 @@ Fields\:
529
529
directly expressible in the type system . This may include experimental GraphQL
530
530
features (such as new syntax or behavior), protocol support (such as GraphQL
531
531
over WebSockets), or additional operational metadata (such as release
532
- identifiers). Capabilities may be supplied by the GraphQL implementation , by the
532
+ identifiers). Capabilities may be supplied by the GraphQL implementation , the
533
533
service , or both .
534
534
535
535
The `__Service .capabilities ` field exposes a _capability_ list . A _capability_
@@ -538,13 +538,13 @@ consists of a capability identifier and optionally a string value.
538
538
**Capability identifier **
539
539
540
540
A capability identifier is a string value composed of two or more segments
541
- separated by a period (`.`). Each segment must begin with a letter and must
542
- contain only alphanumeric characters and hyphens (`[a-zA-Z][a-zA-Z0-9-]*`).
543
- These constraints are inspired by reverse domain name notation to encourage
544
- global uniqueness and collision -resistance . Unlike the domain name system ,
545
- capability identifiers are case sensitive . Identifiers beginning with the prefix
546
- { "org.graphql." } are reserved and must not be used outside of official GraphQL
547
- Foundation specifications . Further , identifiers beginning with the prefix
541
+ separated by a period (`.`). Each segment must begin with an ASCII letter , and
542
+ must contain only ASCII letters , digits and hyphens . These constraints are
543
+ inspired by reverse domain name notation to encourage global uniqueness and
544
+ collision -resistance . Unlike the domain name system , capability identifiers are
545
+ case sensitive . Identifiers beginning with the prefix { "org.graphql." } are
546
+ reserved and must not be used outside of official GraphQL Foundation
547
+ specifications . Further , identifiers beginning with the prefix
548
548
{"org.graphql.http." } are reserved for use by the GraphQL -over -HTTP
549
549
specification , and identifiers beginning with the prefix {"org.graphql.rfc." }
550
550
are reserved for RFC proposals .
@@ -567,12 +567,11 @@ interoperability, while avoiding tight coupling to specific implementations.
567
567
568
568
**Capability value **
569
569
570
- The value assigned to a given capability may either be {null } to indicate that
571
- the capability is supported and requires no additional information , or a string
572
- to provide additional information . For example {"org.graphql.onError" } does not
573
- require additional information and thus uses the value {null }, whereas
574
- {"org.graphql.defaultErrorBehavior" } needs the {value } to indicate which _error
575
- behavior_ is the default .
570
+ The value assigned to a given capability may either be {null } to simply indicate
571
+ the capability is supported , or a string to provide additional information . For
572
+ example {"org.graphql.onError" } does not require additional information and thus
573
+ uses the value {null }, whereas {"org.graphql.defaultErrorBehavior" } needs the
574
+ {value } to indicate which _error behavior_ is the default .
576
575
577
576
**Specified capabilities **
578
577
0 commit comments