Web プラットフォーム設計原則 — Web Platform Design Principles

1.1. 利用者の必要性を第一に置くこと（~~対象者の優先度）

~trade-offを為す必要がある場合、 常に，利用者の必要性を他のすべてより上に置くこと。 ◎ If a trade-off needs to be made, always put user needs above all.

類似に，~APIを設計し始めるときは、 当の~APIが取組もうと目指す利用者の必要性【！need】を理解して，それを文書化すること。 ◎ Similarly, when beginning to design an API, be sure to understand and document the user need that the API aims to address.

`~internetは末端-利用者のためにある＠~RFCx/rfc8890$： ~web~platformに為される どの変更も， `膨大な数の人々に影響する＠~ETHICAL-PRINCIPLES#allpeople$能性があり、 どの個人の生活にも根深い影響iがあり得る。 `RFC8890$r ◎ The internet is for end users: any change made to the web platform has the potential to affect vast numbers of people, and may have a profound impact on any person’s life. [RFC8890]

次も見よ ⇒＃ `§ ~webは、社会に害をもたらさない＠~ETHICAL-PRINCIPLES#noharm$ ／ `§ ~webは、各個人による制御と力を増強する＠~ETHICAL-PRINCIPLES#control$ ／ `RFC8890$r ◎ See also: • The web should not cause harm to society • The web must enhance individuals' control and power • [RFC8890]

1.2. ~web~pageは安全に訪問できるべきである

新たな特能を追加するときは、 利用者の期待 — ~web~pageを訪問することは、 一般に安全であること — を保全するように設計すること。 ◎ When adding new features, design them to preserve the user expectation that visiting a web page is generally safe.

~Webは、 その~hyperlinkされた構造に因んで命名された。 ~webが活発であり続けるためには、 利用者が次を期待-可能になる必要がある ⇒ 所与の どの~linkに対しても、 それをただ訪問しただけでは，［ 利用者の~computer~security／ 利用者の`~privacy＠~ETHICAL-PRINCIPLES#privacy$の本質的な側面 ］に対する含意は無い。 ◎ The Web is named for its hyperlinked structure. In order for the web to remain vibrant, users need to be able to expect that merely visiting any given link won’t have implications for the security of their computer, or for any essential aspects of their privacy.

例えば、 ある~APIが，どの~web~siteにも `支援技術の利用を検出する＠#do-not-expose-use-of-assistive-tech$ことを許容すると、［ どの~web~pageも，この私的な情報を検出し得る ］ようになるので，これらの技術の利用者は［ 未知な~web~pageを訪問するのは安全でない ］と感じるようになる。 ◎ For example, an API that allows any website to detect the use of assistive technologies may make users of these technologies feel unsafe visiting unknown web pages, since any web page may detect this private information.

利用者が安全性に現実的な期待を持てるならば、 彼らは［ ~Webに基づく技術, 他の技術 ］どちらにするか，~~情報を得た下で裁定を下せるようになる。 例えば，利用者は、 ~appを~installするより，~webに基づく食品注文~pageを利用する方を選ぶであろう — ~native~appを~installするのは、 ~web~pageを訪問するより~riskが高いので。 ◎ If users have a realistic expectation of safety, they can make informed decisions between Web-based technologies and other technologies. For example, users may choose to use a web-based food ordering page, rather than installing an app, since installing a native app is riskier than visiting a web page.

~web上の安全性の現実が利用者の期待に合致する方へ必ず向かうよう作業するため、 新たな特能を追加するときは，相補的な~approachをとれる： ◎ To work towards making sure the reality of safety on the web matches users' expectations, we can take complementary approaches when adding new features:

• 利用者は~UIを通して~Webを利用する — ~UIは、［ 利用者が期待するもの（および，しないもの）は何であるべきか ］が より明瞭になるよう，改善できる。 ◎ We can improve the user interfaces through which the Web is used to make it clearer what users of the Web should (and should not) expect;
• ~Webの技術的な土台は、 ~privacyに関する利用者の期待に合致するよう，変更できる。 ◎ We can change the technical foundations of the Web so that they match user expectations of privacy;
• 期待が もっと高かったなら，利用者にとって より良くなる事例を考慮できる。 そのような事例では、 技術的な［ 土台, 期待 ］どちらも変更しようと試行できる。 ◎ We can consider the cases where users would be better off if expectations were higher, and in those cases try to change both technical foundations and expectations.

新たな特能が安全性の~riskを導入する場合でも、 それが［ 利用者にとって、 同じ~taskを~web~page上で遂行する方が， ~native~appを~installするより安全になる ］ことを許容するならば， 利用者の安全性は総合的に改善され得る。 しかしながら，この便益は、［ ~web~pageの安全性に適理な期待を有している利用者たち ］の共通な目標と比較検討される必要がある。 ◎ A new feature which introduces safety risks may still improve user safety overall, if it allows users to perform a task more safely on a web page than it would be for them to install a native app to do the same thing. However, this benefit needs to be weighed against the common goal of users having a reasonable expectation of safety on web pages.

次も見よ ⇒ `~securityと~privacyに関する自己-考査＠~SECQ$cite ◎ See also: • Security and Privacy Self-Review

1.3. 信用-済み~UIは信用に価するべきである

新たな特能が信用-済み~UIに影響iするかどうかを考慮すること。 ◎ Consider whether new features impact trusted user interfaces.

利用者は、［ ~URL~bar／~security指示子／許可~prompt ］などの信用-済み~UIに依存して，自身が誰とどうヤリトリしているかを理解する。 これらの信用-済み~UIは、 それらが供する情報が［ 本物であって，当の~web~siteにより［ 偽装されていない／乗取られていない ］こと ］を利用者が［ 信用する, `検証yする＠~ETHICAL-PRINCIPLES#verify$ ］ことを可能化するような仕方で，設計-可能でなければナラナイ。 ◎ Users depend on trusted user interfaces such as the address bar, security indicators and permission prompts, to understand who they are interacting with and how. These trusted user interfaces must be able to be designed in a way that enables users to trust and verify that the information they provide is genuine, and hasn’t been spoofed or hijacked by the website.

新たな特能が，信用-済み~UIを真似ることを信用-済みでない~UIに許容する場合、 利用者にとって，どの情報が信用に価するか理解するのは より困難になる。 ◎ If a new feature allows untrusted user interfaces to resemble trusted user interfaces, this makes it more difficult for users to understand what information is trustworthy.

1.4. 有意義な同意を利用者に依頼すること

~web~pageは、 利用者の必要性を充足している文脈において， 害を及ぼす能性がある特能を用立てるよう求めることもある。 そのような特能は、 人々が［ その利用に先立って`有意義な同意＠~ETHICAL-PRINCIPLES#control$を与えれる ］かつ［ 同意を効果的に拒否できる ］ように設計されるべきである。 ◎ In the context of fulfilling a user need, a web page may want to make use of a feature that has the potential to cause harm. Features that have this potential for harm should be designed such that people can give meaningful consent for that feature to be used, and that they can refuse consent effectively.

利用者から`有意義な同意^emを得るためには、 利用者にとって，次が可能にならなければナラナイ： ◎ In order to give meaningful consent, the user must:

• 何を~web~pageに許可する（しない）のか`理解する^strong。 ◎ understand what permission they may choose whether to grant the web page
• その許可を［ 是認する／拒否する ］ことを`効果的^strongに選ぶ。 ◎ be able to choose to give or refuse that permission effectively.

ある特能が利用者からの同意を要求するほど十分に強力であるが， 典型的な利用者に何を同意しているのか説明することはアリでない場合、 それは，当の特能の設計を考慮し直す必要があろう兆候である。 ◎ If a feature is powerful enough to require user consent, but it’s impossible to explain to a typical user what they are consenting to, that’s a signal that you may need to reconsider the design of the feature.

ある許可~promptが示され，利用者が許可を是認しなかった場合、 ~web~pageは，利用者が同意を拒否したと信じたものを行えるようになるべきでない。 ◎ If a permission prompt is shown, and the user doesn’t grant permission, the Web page should not be able to do anything that the user believes they have refused consent for.

同意を依頼することにより，~web~pageが何の能力を［ 有するか／有さないか ］を利用者に伝えられれば、 利用者にとって`~webは安全である＠#safe-to-browse$確証は高まる。 しかしながら，新たな特能による`利用者の便益＠#priority-of-constituencies$は、 利用者に対する追加的な負担 — 各~特能に対し，~web~pageから要請される度に許可を是認するかどうか裁定する — を正当化しなければナラナイ。 ◎ By asking for consent, we can inform the user of what capabilities the web page does or doesn’t have, reinforcing their confidence that the web is safe. However, the user benefit of a new feature must justify the additional burden on users to decide whether to grant permission for each feature whenever it’s requested by a Web page.

当の仕様において同意を依頼するための良い仕方として、［ `利用する許可を要請する$, `選ぶよう利用者に~promptする$ ］~algo `permissions$r が挙げられる。 ◎ In your specification, the request permission to use and prompt the user to choose algorithms from [permissions] are good ways to ask for consent.

拒否と他の共通的な状況を~siteが判別できない場合、 拒否が最も効果的である。 そうすれば、 ~siteが［ 利用者に対し同意を是認するよう迫る ］ことは，より困難になり得る。 ◎ Refusal is most effective if the site cannot distinguish refusal from other, common situations. This can make it more difficult for a site to pressure users to grant consent.

次も見よ ⇒＃ `§ ~webは、~secureであり，人々の~privacyを尊重する＠~ETHICAL-PRINCIPLES#privacy$／ `§ 同意~原則＠~PRIVACY-PRINCIPLES#consent-principles$／ `PERMISSIONS$r ◎ See also: • The web is secure, and respects people’s privacy • Consent Principles • Permissions

1.5. 識別情報を文脈において適切に利用すること

人々が［ 様々な文脈の下で，~webに対し呈示している自身についての識別用の情報 ］に対する`制御＠~ETHICAL-PRINCIPLES#control$を彼らに与えること — それついて透明であること。 ◎ Give people control over the identifying information about themselves they are presenting in different contexts on the web, and be transparent about it.

“識別情報（ `identity^en ）” は、 多くの異なる仕方で理解され得る，複階的な概念である。 それは、 誰かが自身を［ どう呈示するか／どう見ているか ］を指すことも，自身が［ 他の人々／~group／団体 ］（順不同）とどう関係するかを指すこともあり、 その者が［ どう挙動するか／他者によりどう扱われるか ］（順不同）を決定し得る。 ~web~architectureにおける “識別情報” は、［ 識別子や, それに付された情報 ］を指す総称として利用されることが多い。 ◎ "Identity" is a complex concept that can be understood in many different ways. It can refer to how someone presents or sees themselves, how they relate to other people, groups, or institutions, and can determine how they behave or how they are treated by others. In web architecture, "identity" is often used as a shortcut to refer to identifiers, and the information attached to them.

［ 識別子や，それに付された ある個人についての~data ］を［ 利用する, あるいは それに依存する ］特能は、［ 単独の［ ~API／~system ］を超えて到達することが多い~privacy~risk ］を運ぶ。 これには、 受動的に生成された~data （例：~web上での彼らの挙動について）も， 能動的に収集された~data （例：彼らが ある~form内で埋めたもの）も含まれる。 ◎ Features that use or depend on identifiers and the attachment of data about a person to that identifier carry privacy risks which often reach beyond a single API or system. This includes data that has been passively generated (for example, about their behaviour on the web) as well as that which has been actively collected (for example, they have filled in a form).

そのような特能に対しては、 それが利用されることになる`文脈を理解する＠~PRIVACY-PRINCIPLES#identity$ベキである — それが［ ~webを成す他の特能と~~並行して，どう利用されることになるか ］も含めて。 利用者が`適切な同意を与えれる＠#consent$ようにすること。 ~APIが収集する~dataの量は`必要yな~~最小限になる＠~PRIVACY-PRINCIPLES#data-minimization$よう設計すること。 持続的な識別子が絶対的に必要yでない限り、 短期的かつ一時的な識別子を利用すること。 ◎ For such features, you should understand the context in which it will be used, including how it will be used alongside other features of the web. Make sure the user can give appropriate consent. Design APIs to collect the smallest amount of data necessary. Use short-lived, temporary identifiers unless a persistent identifier is absolutely necessary.

1.6. 全部的な範囲の装置と~platformを~supportすること（媒体からの独立性）

~web上の特能は、 アリな限り`多くの異なる＠~ETHICAL-PRINCIPLES#multi$［ 入力~装置／出力~装置／~screen~size／対話~mode／~platform／媒体 ］にまたがって働くことを確保すること。 ◎ As much as possible, ensure that features on the web work across different input and output devices, screen sizes, interaction modes, platforms, and media.

~Webの主な価値の一つは、 極めて柔軟なことにある： ある~web~pageは、［ 多様な消費者~計算機で様々な~sizeの~screenで視られる／ 印刷される媒体を生成するために利用される／ 数多くの異なる仕方でヤリトリされる ］こともある。 新たな特能は、 ~web~platformの`既存の柔軟性＠~ETHICAL-PRINCIPLES#render$に合致するべきである。 ◎ One of the main values of the Web is that it’s extremely flexible: a Web page may be viewed on virtually any consumer computing device at a very wide range of screen sizes, may be used to generate printed media, and may be interacted with in a large number of different ways. New features should match the existing flexibility of the web platform.

特能はまた、［ それを利用する最も容易な仕方は，柔軟性を保守する ］ように設計されるべきである。 ◎ Features should also be designed so that the easiest way to use them maintains flexibility.

特能は、 ときには，一部の［ 実装／~platform ］では まだ可用でないこともある — 他では働くにもかかわらず。 そのような事例では、 当の特能は，［ 上品に失敗する, あるいは~polyfillするための~codeがアリになる ］ように設計されるベキである。 `§ 新たな特能は検出-可能になるべきである＠#feature-detect$ を見よ。 ◎ Sometimes features aren’t yet available on some implementations or platforms despite working on others. In these cases, features should be designed such that it is possible for code to gracefully fail or be polyfilled. See § 2.6 New features should be detectable.

1.7. 新たな能力は~careの下で追加すること

~webに新たな能力を追加するときは、 既存の［ 機能性／内容 ］を考慮すること。 ◎ Add new capabilities to the web with consideration of existing functionality and content.

~Webには、 追加を許容する拡張~地点が数多くある — 例えば、 `HTML$r `§ 拡張能＠~HTMLintroduction#extensibility$ を見よ。 ◎ The Web includes many extension points that allow for additions; see for example HTML § 1.7.3 Extensibility.

何かを追加する前に，既存の［ 類似な能力 ］との統合を考慮すること。 その結果，選好される設計~approachが［ 何かを追加するだけでは実装し得ないもの ］へ至らす場合でも、 それはアリかもしれない — `§ 能力を［除去する／変更する］前に既存の用法を理解すること＠#removing-features$ を見よ。 ◎ Before adding items, consider integration with existing, similar capabilities. If this leads to a preferred design approach that cannot be implemented by only adding items, it might still be possible; see § 1.8 Remove or change capabilities only once you understand existing usage.

最初に検査することなく，［ 変更／除去 ］はアリでないとは見做さないこと。 ◎ Do not assume that a change or removal is impossible without first checking.

1.8. 能力を［除去する／変更する］前に既存の用法を理解すること

機能性を［ 除去する／変更する ］ときは、 既存の内容との互換性を優先すること。 ◎ Prioritize compatibility with existing content when removing or changing functionality.

有意な量の内容が，特定0の挙動に依存するようになったなら、 その挙動を［ 除去する／変更する ］ことは忌避される。 特能や能力を［ 除去する／変更する ］ことは，アリだが、 まずは，［ 既存の内容に対する影響i ］の資質や視野を理解することが要求される。 これは、［ 既存の内容が当の特能をどう利用しているか ］について事実調査が要求されるかもしれない。 ◎ Once a significant amount of content has come to depend on a particular behavior, removing or changing that behavior is discouraged. Removing or changing features and capabilities is possible, but it first requires that the nature and scope of the impact on existing content is well understood. This might require research into how features are used by existing content.

既存の用法を理解する義務は、 内容が依拠している各~特能にも適用される。 これには、 実装の~bugと見なされるかもしれないような， ~vendorに~proprietaryな特能や挙動も含まれる。 ~web特能は、 仕様のみならず［ そのような特能を内容が どう利用するか ］によっても定義される。 ◎ The obligation to understand existing usage also applies to any features that content relies upon. This includes vendor-proprietary features and behavior that might be considered implementation bugs. Web features are not solely defined in specifications; they are also defined by how content uses those features.

1.9. ~webをより良いものにして残すこと

~web~platformに新たな能力を追加するときは、 ~platformが総合的に改善される仕方で行うこと — 例えば、［ ~security／~privacy／~accessibility ］の特性。 ◎ As you add new capabilities to the web platform, do so in a way that improves the overall platform, for example its security, privacy or accessibility characteristics.

~platformの一部に存在する欠陥を当の欠陥に対する［ 追加／拡張 ］の言い訳として利用してはナラナイ — そうすると，~platformの品質は総合的に劣化するので。 新たな~web能力は、 ~platformの品質が総合的に改善されるよう， アリな所では既存の欠陥を軽減することにより築くこと。 良い理由もなく，既存の能力を退行させないこと。 ◎ The existence of a defect in one part of the platform must not be used to excuse an addition or extension to the defect, which would further decrease the overall platform quality. Where possible, build new web capabilities that improve the overall platform quality by mitigating existing defects. Do not degrade existing capabilities without good reason.

~web~platformの各部は、 独立に発展する。 ある種の~web技術に今在る課題は、 後続な~~版において修正され得る。 これらの課題を重ねて持ち込むと、 修正するのは，さらに困難になる。 この原則を固守することで、 ~platformの品質は，時を経るに伴い総合的に改善されるようになる。 ◎ Parts of the web platform evolve independently. Issues that are present with a certain web technology now may be fixed in a subsequent iteration. Duplicating these issues makes fixing them more difficult. By adhering to this principle we can make sure overall platform quality improves over time.

1.10. 利用者~dataを最小~化すること

特能は、［ その利用者の目標を遂げるために必要yな最小な量の~data ］で働くように設計すること。 ◎ Design features to work with the minimum amount of data necessary to carry out their users' goals.

`~dataの最小~化＠~PRIVACY-PRINCIPLES#data-minimization$は、 ~dataが不適切に［ 開示される／誤って利用される ］~riskを制限する。 ◎ Data minimization limits the risks of data being inappropriately disclosed or misused.

~Web~APIは、 ~siteにとって，［ 少ない量の~data — あるいは，より［ 細やかな／特定な ］【言い換えれば、当の~API用に最適化された】~data — を［ 要請する／収集する／伝送する ］（順不同） ］方が［ より［ 汎用な／~bulkな ］~dataで作業する ］よりも容易になるように設計すること。 ~APIは、 ~siteへ通信される~data — 特に，`個人-~data＠~PRIVACY-PRINCIPLES#dfn-data$ — に対する［ 細やかさ, 利用者-制御 ］も供するベキである。 追加的な機能性に追加的な~dataが要求されるときは、 ~APIは，それを利用者-同意（例：許可~promptや利用者-作動化）の~subjectにすることで可能化できる。 ◎ Design Web APIs to make it easier for sites to request, collect, and/or transmit a small amount of data, or more granular or specific data, than it is to work with more generic or bulk data. APIs should also provide granularity and user controls, in particular over personal data, that is communicated to sites. When additional functionality requires additional data, APIs can enable this subject to user consent (e.g., a permission prompt or user activation).

2.1. 単純な解決策を選好すること

取組もうと意図する`利用者の必要性＠#priority-of-constituencies$に対し， 単純な解決策を探す努力を怠らないこと。 ◎ Look hard for simple solutions to the user needs you intend to address.

一般に、 複階的な解決策より単純な解決策の方が良い — それを見出す方が難しいこともあろうが。 特能は単純な方が ⇒＃ ~UAにとって実装して~testするのは容易になる／ 相互運用可能になる見込みが高い／ 作者が理解するのは容易になる ◎ Simple solutions are generally better than complex solutions, although they may be harder to find. Simpler features are easier for user agents to implement and test, more likely to be interoperable, and easier for authors to understand.＼

とりわけ、 当の特能を［ 最も共通な利用事例を容易に成遂げる ］よう設計することが重要である。 ◎ It is especially important to design your feature so that the most common use cases are easy to accomplish.

`利用者の必要性＠#priority-of-constituencies$をきちんと定義すること — そうすれば、 視野が次第に逸れていくこと（ `scope creep^en ）は避けれるようになる。 また、 当の~APIが，すべての利用者の必要性を実際に満たすようにすること。 もちろん［ 複階的／稀 ］な利用事例も解くに価するが、 それらの解決策は利用するのが複雑なこともある。 `Alan Kay^en 氏が言ったとおり， “`simple things should be simple, complex things should be possible^en” 【 “単純なものは単純にしつつ，複階的なものもアリになるべきである” 】。 ◎ Make sure that your user needs are well-defined. This allows you to avoid scope creep, and make sure that your API does actually meet the needs of all users. Of course, complex or rare use cases are also worth solving, though their solutions may be more complicated to use. As Alan Kay said, "simple things should be simple, complex things should be possible."

共通な事例は単純なことが多いが、 共通度と複階度は，常に相関するとは限らないことに注意。 ◎ Do note however that while common cases are often simple, commonality and complexity are not always correlated.

次も見よ ⇒ `LEAST-POWER$r ◎ See also: • [LEAST-POWER]

2.2. 高~levelな~APIと低~levelな~APIの~tradeoffを考慮すること

高~levelな~APIは、 `利用者に利する＠#priority-of-constituencies$ために — ［ ~accessibility／~privacy／利便性 ］を確保するためなど — 様々な仕方で介入する能を より多く~UAに許容する。 ◎ High-level APIs allow user agents more ability to intervene in various ways on behalf of the user, such as to ensure accessibility, privacy, or usability.

低~levelな~APIには、［ 高~levelな~APIが，時を経て得られた用法~patternから組織的に形作れる ］よう，作者に実験n用の部屋を与えるゆとりがある。 それはまた、［ より高~levelな~APIでは必要十分でない，目の前の利用事例 ］のための逃げ道を供する。 ◎ Low-level APIs afford authors room for experimentation so that high level APIs can organically emerge from usage patterns over time. They also provide an escape hatch when the higher-level API is not adequate for the use case at hand.

より低~levelな構築部品は、 ~Web~APIとして公開できないこともある。 アリな理由として，［ 利用者の~securityと~privacyを保全する／ ~Web~APIを特定の~hardware実装に束ねるのを避ける ］ことが挙げられる。 しかしながら，高~levelな~APIは、［ アリなときは，より低~levelな~APIに基づく構築部品の用語 ］で設計されるべきである。 これは、［ 高~levelな~APIは，どうなる必要があるか ］に関する裁定を手引きするものになろう。 ◎ Lower level building blocks cannot always be exposed as Web APIs. A few possible reasons for this are to preserve the user’s security and privacy, or to avoid tying Web APIs to specific hardware implementations. However, high level APIs should be designed in terms of building blocks over lower level APIs whenever possible. This may guide decisions on how high level the API needs to be.

きちんと層~化された解決策は、［ その力に比して，利用の難易度がひどく上がることはない ］ことを確保するべきである — 利用事例の複階性が少し増すだけで~codeの複階性が大きく増えないよう。 ◎ A well-layered solution should ensure continuity of the ease-of-use vs power tradeoff curve and avoid sharp cliffs where a small amount of incremental use case complexity results in a large increase of code complexity.

2.3. よく考して命名すること

【！Name APIs with care.】 ~APIをきちんと命名しておけば、 作者が それを正しく利用するのは，ずっと容易になる。 ◎ Name APIs with care. Naming APIs well makes it much easier for authors to use them correctly.

命名に特有な，より詳細な指導は、 `§ 命名~原則＠#naming-is-hard$を見よ。 ◎ See the more detailed Naming principles section for specific guidance on naming.

2.4. 他所と一貫すること

~APIの設計における先例を考慮して，それと一貫するよう努めることは、 良い実施である。 ◎ It is good practice to consider precedent in the design of your API and to try to be consistent with it.

既存の先例の利便性が拙い場合、 ~APIの［ 人間工学, 一貫性 ］両面は対立することが多い。 一部の事例では，一貫性を破ってでも利便性を改善することがイミを成すが、 その改善は，そうすることを有意に正当化するものであるべきである。 ◎ There is often a tension between API ergonomics and consistency, when existing precedent is of poor usability. In some cases it makes sense to break consistency to improve usability, but the improvement should be very significant to justify this.

~web~platformは、 時を経て次第に発展してきたので， 相反な複数の競合している先例があることも多い。 どの先例に従うかは、 次を織り込む下で比較検討できる： ◎ Since the web platform has gradually evolved over time, there are often multiple conflicting precedents which are mutually exclusive. You can weigh which precedent to follow by taking into account＼

• 普及度（他がすべて等しいなら，より普及な先例に従う） ◎ prevalence (all else being equal, follow the more popular precedent),＼
• 人間工学（他がすべて等しいなら，より利用-可能な先例に従う） ◎ API ergonomics (all else being equal, follow the more usable precedent),＼
• ~APIの齢（他がすべて等しいなら，より新たな先例に従う） ◎ and API age (all else being equal, follow the newer precedent).

［ `内部~一貫性^em, `外部~一貫性^em ］も対立することが多い。 前者は，当の~systemの他所すべてとの一貫性であり、 後者は，外の世界の他所すべてとの一貫性である。 それは、 ~web~platformにおいては，次に挙げる 3 つの層で顕在化されよう： ◎ There is often a tension between internal and external consistency. Internal consistency is consistency with the rest of the system, whereas external consistency is consistency with the rest of the world. In the web platform, that might materialize in three layers:＼

• 当の~APIが所属する技術（例：~CSS）との一貫性 ◎ consistency within the technology the API belongs to (e.g. CSS),＼
• ~web~platformの他所すべてとの一貫性 ◎ consistency with the rest of the web platform,＼
• 一部の事例 — 当の~APIが［ 特定0の特化された外側の領分 ］に関係する事例 — では、 外部な先例との一貫性 ◎ and in some cases external precedent, when the API relates to a particular specialized outside domain.＼

これらの事例では、［ 大多数の利用者は，どれに該当するか ］を考慮することが有用になる。 ほとんどの~APIは、 それが ある技術の下で定義されるならば，~target利用者は その技術に馴染みな者たちなので、 その技術との一貫性を支持する方が無難になる。 ◎ In those cases, it is useful to consider what the majority of users will be. Since for most APIs the target user is someone who is familiar with the technology they are defined in, err on the side of favoring consistency with that.

別々な節として， `§ 一貫するよう命名すること＠#naming-consistency$もある。 ◎ There is also a separate section on naming consistency.

2.5. 特能~仕様からの指導に従うこと

ある特能を利用しているときは、 その特能~用の仕様による指導に従うこと。 ◎ When using a feature, follow guidance in the specification for that feature.

他の仕様により利用されることになる特能~用の仕様は、 当の特能を利用するための指導を含めるベキである。 これは、 当の特能が~platform全体を通して正しくかつ一貫するよう利用されることを確保する。 ◎ Specifications for features that will be used by other specifications should include guidance for using those features. This ensures that the feature is used correctly and consistently throughout the platform.

そのような指導を成す例として，次が挙げられる ⇒＃ `ENCODING$r `§ 他の標準~用の~hook＠~ENCODING#specification-hooks$, `FETCH$r `§ 他の標準における~fetchの利用-法＠~FETCH#fetch-elsewhere$, `RFC9205$r — とりわけ `§ ~HTTP~headerの指定-法＠~HTTPbcp#headers$, `他の~HTTP~RFC群＠https://datatracker.ietf.org/doc/search?name=HTTP&sort=&rfcs=on&by=group&group=httpbis$, `HIGHRES-TIME$r `§ 仕様~策定者~用の~tool＠~HRTIME#sec-tools$, `URL$r `§ 他の仕様における~URL~API＠~URL1#url-apis-elsewhere$, ◎ An incomplete list of such guidance follows: • Encoding • Fetch • Building Protocols with HTTP, especially on defining header fields, and other HTTP RFCs • Time • URLs

そのような仕様を利用しているときは、 関連な~communityに諮ること。 そうすることで、 新たな用法について当の~communityに伝わり， 利用している仕様, 利用された仕様どちらにも改善~用の機会が与えられる。 ◎ Consult with the relevant community when using their specification. This informs that community about new usage and creates opportunities for improvements to both the using and used specifications.

2.6. 新たな特能は検出-可能になるべきである

当の特能が可用でないときでも，~web内容が それを上品に取扱えるよう、 可用かどうかを作者が~program的に検出する仕方を供すること。 ◎ Provide a way for authors to programmatically detect whether your feature is available, so that web content may gracefully handle the feature not being present.

既存の特能は、 いくつかの理由から，~pageにて可用でないこともある。 共通的な理由として、 次が挙げられる ⇒＃ まだ実装されていない／ `~secureな文脈＠#secure-context$内でしか可用でない ◎ An existing feature may not be available on a page for a number of reasons. Two of the more common reasons are because it hasn’t been implemented yet, or because it’s only available in secure contexts.

作者にとって［ 各~局面を取扱うために異なる~codeを書する必要 ］は、 生じるべきでない。 この仕方により、 作者が一つの局面しか［ 知らない／~careしない ］場合でも，~codeは それらすべてを取扱うことになる。 ◎ Authors shouldn’t need to write different code to handle each scenario. That way, even if an author only knows or cares about one scenario, the code will handle all of them.

注記： ある特能が［ 可用ではあるが、 要求される装置が無いため，その利用は実現可能でない ］ときは、 特能が可用であることを公開することに加え， 装置は可用でないことも検出する別々な仕方もある方が良い。 これは、［ 装置が可用でないとき, 特能が可用でないとき ］の取扱いを違えることを作者に許容する — 例えば、 装置を［ 前者のときは接続する／後者のときは可能化する ］よう利用者に示唆するなど。 ◎ When a feature is available but isn’t feasible to use because a required device isn’t present, it’s better to expose that the feature is available and have a separate way to detect that the device isn’t. This allows authors to handle a device not being available differently from the feature not being available, for example by suggesting the user connect or enable the device.

`§ 装置を［選定する／列挙する］~APIを公開するときの注意点＠#device-enumeration$ を見よ。 ◎ See § 9.2 Use care when exposing APIs for selecting or enumerating devices.

特能は、 常に，作者が~JSから検出-可能にするべきである。 一部の事例では、 特能は，それが利用される言語で検出-可能になるべきである （~CSSにおける `supports$at など）。 ◎ Authors should always be able to detect a feature from JavaScript, and in some cases the feature should also be detectable in the language where it’s used (such as @supports in CSS).

一部の事例では、 特能~検出を許容するのは`適切でないこともある^strong。 特能が検出-可能になるべきかどうかは、 当の特能に対する`利用者の必要性＠#priority-of-constituencies$に基づく — 特能~検出が可用であること自体が［ 利用者の必要／設計~原則 ］に抵触する場合、 特能~検出は~supportされるべきでない。 ◎ In some cases, it may not be appropriate to allow feature detection. Whether the feature should be detectable or not should be based on the user need for the feature. If there is a user need or design principle which would fail if feature detection were available for the feature, then you should not support feature detection.

ある特能が可用か否か検出することは、 当の特能を利用する`同意＠#consent$が是認されたか否か検出することを含意しない。 一般に、［ 当の特能が実装されたかどうか検出する ］ことは［ 当の特能の利用について権限付与-済みかどうか決定する ］こととは別々に行える。 一部の事例では、［ 当の特能を利用する要請を否認する ］ことを可能化するためには，特能~検出を不能化することが必要yあるかもしれない。 ◎ Detecting the availability of a feature does not imply detecting whether consent to use the feature has been granted. Generally, detecting whether the feature is implemented can be done separately from determining whether use of the feature has been authorized. In some cases, it might be necessary to disable feature detection in order to enable denying requests to use the feature.

また，ある特能が一般に開発者に公開されない場合、 特能~検出を~supportするのは適切にならない。 例えば，私的~閲覧~modeは、 ~web仕様において認識される概念であるが，作者には公開されない。 私的~閲覧~modeに対する特能~検出は、 それ自体が利用者の必要性に反するので，~supportされてはナラナイ。 ◎ Also, if a feature is generally not exposed to developers, it is not appropriate to support feature detection. For example, private browsing mode is a concept which is recognised in web specifications, but not exposed to authors. For private browsing mode to support the user’s needs, it must not be feature detected.

次も見よ ⇒＃ `§ 私的~閲覧~mode下にあることを露呈しないこと＠#do-not-expose-use-of-private-browsing-mode$／ `§ 支援技術が利用-中にあることを露呈しないこと＠#do-not-expose-use-of-assistive-tech$／ `§ 新たな特能は~secureな文脈に制限することを考慮すること＠#secure-context$／ `§ 有意義な同意を利用者に依頼すること＠#consent$ ◎ See also: • § 2.9 Don’t reveal that private browsing mode is engaged • § 2.11 Don’t reveal that assistive technologies are being used • § 2.8 Consider limiting new features to secure contexts • § 1.4 Ask users for meaningful consent

2.7. ~textな形式はヒトのために設計すること

~textな形式は、 人々が容易に生産でき, 消費できるよう，設計すること。 ~textな形式は、 `透明~性＠~ETHICAL-PRINCIPLES#transparent$も改善する。 ◎ Design textual formats that can be easily produced and consumed by people. Textual formats also improve transparency.

密集~度よりも可読性を支持すること。 ~file~sizeは、 ~tool群により最適化し得ることに加え，その優先度は時間~越しに低下する傾向にある。 ~file~sizeの優先度が他より有意に高いときは、 ~textな形式は，たぶん適切でない。 ◎ Favor readability over compactness. File size can be optimized by tooling, and tends to become a lower priority over time. When file size is a significantly higher priority, perhaps a textual format is not appropriate.

~textな形式で呈示されるなら、 人々は，~text~editorを利用して内容を容易に［ 生産-／改変- ］可能になるはずである。 人々は、 ~textを編集する際に様々な~errorを導入することになるが， それらの~errorを識別して修正することにも苦労し得る。 ◎ People who are presented with a textual format should be able to use a text editor to easily produce or modify content. People who edit text will introduce a range of errors, but could struggle to identify and fix those errors.

人々は、 各自の編集sがどう処理されるかに関して，いくぶんの柔軟性を期待する。 構文上の柔軟性を — 空白, 引用符, 区切子などの入れ方に関して — `明瞭に定義すること＠#avoid-ambiguity$により，［ 内容が編集し易くなること, 【柔軟性の下で等価なものどうしで】一貫した結果を生産すること ］どちらも確保され得る。 ◎ People expect some amount of flexibility in terms of how their edits are processed. Clearly defining syntactic flexibility—​such as in whitespace, quoting, or delimiters—​could ensure that content is both easy to edit and produces consistent results.

ある形式を成す［ 構文~errorにより影響される視野 ］を~~狭めることは、 堅牢~性もヒトにとっての利便性も改善し得る。 これには、 各~仕様が，その処理と~errorの取扱いを［ すべての入力に対する最終的な結果が一貫するよう，全部的に定義する ］ことが要求される。 ◎ Containing the scope of a format that is affected by a syntax error could improve robustness and human usability. This requires that specifications fully define processing and error handling so that all inputs result in consistent outcomes.

当の形式が機械にしか利用されないものと意図される場合、 ~binary形式の方が効率的になる見込みが高い — 人々が内容を直に［ 著作する／編集する ］ことは忌避されることに加えて。 ◎ If your format is intended to be used only by machines, a binary format is likely to be more efficient, in addition to discouraging people from authoring or editing content directly.

2.8. 新たな特能は~secureな文脈に制限することを考慮すること

当の特能が［ ~secureな文脈にしか無い［ 認証／完全性／機密性 ］を伴わない限り，利用者に~riskを突きつける ］ことになる場合、 常に~secureな文脈に制限すること。 ◎ Always limit your feature to secure contexts if it would pose a risk to the user without the authentication, integrity, or confidentiality that’s present only in secure contexts.

他の特能に対しては、 ~~過去および~~現在の~TAG~memberたちは，一般的な助言について総意には達しなかった： ◎ For other features, TAG members past and present haven’t reached consensus on general advice.＼

• 一部の者は、 新たな特能（既存の特能に対する追加~以外の特能）は，［ すべて，~secureな文脈に制限されるべきである ］と予見する。 これは，~HTTPSの利用を促すことになり、 一般に，利用者にとって より~secureになる助けになる。 ◎ Some believe that all new features (other than features which are additions to existing features) should be limited to secure contexts. This would help encourage the use of HTTPS, helping users be more secure in general.
• 他の者は、 特能は，［［ ~security／~privacy ］に既知な影響iがある場合に限り，~secureな文脈に制限されるべきである ］と予見する。 これは、［［ 利用者の［ ~security／~privacy ］に影響iしない新たな特能 ］の利点を採るような~web~page ］を作成するときの敷居を低くする。 ◎ Others believe that features should only be limited to secure contexts if they have a known security or privacy impact. This lowers the barrier to entry for creating web pages that take advantage of new features which don’t impact user security or privacy.

2.9. 私的~閲覧~mode下にあることを露呈しないこと

当の特能は、 私的~閲覧~modeを検出する仕方を作者に与えないこと。 ◎ Make sure that your feature doesn’t give authors a way to detect private browsing mode.

一部の人々は、 `私的~閲覧~mode＠https://www.w3.org/2001/tag/doc/private-browsing-modes/$を利用して，自前の個人的な安全性を保護する。 このことから，誰かが私的~閲覧~modeを利用している事実は、 その者についての `敏感な情報＠~SECQ#sensitive-data$になり得る。 この情報は、 その者に力を持つ他者 （雇用者, 親権者, ~partner, `国家権力＠~ETHICAL-PRINCIPLES#expression$（ `state actor^en ） など） が制御している~web~siteに露呈された場合には， `人々を害する＠~ETHICAL-PRINCIPLES#noharm$こともある。 ◎ Some people use private browsing mode to protect their own personal safety. Because of this, the fact that someone is using private browsing mode may be sensitive information about them. This information may harm people if it is revealed to a web site controlled by others who have power over them (such as employers, parents, partners, or state actors).

そのような危険性がある下では、 ~web~siteは，私的~閲覧~mode下にあることを検出-可能になるべきでない。 ◎ Given such dangers, websites should not be able to detect that private browsing mode is engaged.

次も見よ ⇒＃ `§ ~webは、~secureであり，人々の~privacyを尊重する＠~ETHICAL-PRINCIPLES#privacy$／ `§ 当の特能は、下層の~platformについての情報を生成元に公開するか？＠~SECQ#underlying-platform-data$／ `§ 私的~閲覧~modeにおいて，~APIがどう挙動するべきか考慮すること＠#private-browsing-mode$ ◎ See also: • Security and privacy are essential • What data does this specification expose to an origin? • § 2.10 Consider how your API should behave in private browsing mode

2.10. 私的~閲覧~modeにおいて，~APIがどう挙動するべきか考慮すること

必要yなら、 当の~APIの挙動は，私的~閲覧~modeにおいて どう異なるべきかを指定すること。 ◎ If necessary, specify how your API should behave differently in private browsing mode.

例えば，当の~APIが［ 一人の利用者による［ 私的~閲覧~mode内での活動, その外での活動 ］を相関することを誰かに許容することになる情報 ］を露呈することになる場合、 アリな`軽減策＠~SECQ#mitigations$を考慮すること — 次に挙げるものなど： ◎ For example, if your API would reveal information that would allow someone to correlate a single user’s activity both in and out of private browsing mode, consider possible mitigations such as＼

• 【相関を妨げるような】~noiseを導入する。 ◎ introducing noise,＼
• 許可~promptを利用して，当の利用者に加的な情報を与える — 利用者が，この追跡に有意義に同意する助けになるよう （`§ 有意義な同意を利用者に依頼すること＠#consent$を見よ）。 ◎ or using permission prompts to give the user extra information to help them meaningfully consent to this tracking (see § 1.4 Ask users for meaningful consent).

私的~閲覧~modeは、［ 利用者による私的~閲覧の形跡を利用者の機器に残さない ］ように~webを閲覧することを，利用者に可能化する。 したがって， ~client側~storageを供する~APIは、［ 私的~閲覧~mode下にある間に格納された~data ］を その~modeから離れた後にも持続するべきでない。 これは、［ 検出-可能な~APIにおける いかなる相違も，当の~siteに露呈しない ］ように行えるし，行うべきである。 ◎ Private browsing modes enable users to browse the web without leaving any trace of their private browsing on their device. Therefore, APIs which provide client-side storage should not persist data stored while private browsing mode is engaged after it’s disengaged. This can and should be done without revealing any detectable API differences to the site.

次も見よ ⇒＃ `§ 私的~閲覧~mode下にあることを露呈しないこと＠#do-not-expose-use-of-private-browsing-mode$／ `§ 当の特能は、複数の閲覧~sessionにわたって持続する新たな状態を生成元~用に導入するか？＠~SECQ#persistent-origin-specific-state$／ `§ 当の特能は、~browserの私的~閲覧~modeの文脈においてどう働くか？＠~SECQ#private-browsing$ ◎ See also: • § 2.9 Don’t reveal that private browsing mode is engaged • Does this specification introduce new state for an origin that persists across browsing sessions? • Security and privacy self review: Private Browsing

2.11. 支援技術が利用-中にあることを露呈しないこと

当の~APIは、 利用者が支援技術を利用していることを［ 利用者の同意を経ることなく検出する仕方 ］を作者に供さないこと。 ◎ Make sure that your API doesn’t provide a way for authors to detect that a user is using assistive technology without the user’s consent.

`~web~platformは障害を伴う人々からも~access可能にしなければナラナイ＠~ETHICAL-PRINCIPLES#allpeople$。 ある~siteが利用者が支援技術を利用していることを検出できた場合、 その~siteは，自身が供する~serviceへの利用者による~accessを［ 否認-／制約- ］し得ることになる。 ◎ The web platform must be accessible to people with disabilities. If a site can detect that a user is using an assistive technology, that site can deny or restrict the user’s access to the services it provides.

支援技術を用立てる人々は、 `社会の脆弱な~member＠~ETHICAL-PRINCIPLES#noharm$ であることが多い。 彼らによる支援技術の利用は、 彼らについての`敏感な情報＠~SECQ#sensitive-data$である。 ある~APIが，この情報への~accessを`利用者の同意＠#consent$を経ることなく供する場合、 この敏感な情報は，彼らを害そうと望むかもしれない他者 （`国家権力＠~ETHICAL-PRINCIPLES#expression$も含む） に露呈され得る。 ◎ People who make use of assistive technologies are often vulnerable members of society; their use of assistive technologies is sensitive information about them. If an API provides access to this information without the user’s consent, this sensitive information may be revealed to others (including state actors) who may wish them harm.

ときには、 人々は［ 支援技術の利用者~用に利用者~体験を改善しようと目指す特能 ］を提案するが，それは［ 副作用として利用者の支援技術の利用を露呈する ］ことになろう。 これらには，きちんとした意図nがあるが、 `§ ~web~pageは安全に訪問できるべきである＠#safe-to-browse$ に違反するので，代替な解決策を見出さなければナラナイ。 ◎ Sometimes people propose features which aim to improve the user experience for users of assistive technology, but which would reveal the user’s use of assistive technology as a side effect. While these are well intentioned, they violate § 1.2 It should be safe to visit a web page, so alternative solutions must be found.

次も見よ ⇒＃ `~Web技術~accessibility指針＠https://w3c.github.io/apa/fast/$cite `§ ~webは、~secureであり，人々の~privacyを尊重する＠~ETHICAL-PRINCIPLES#privacy$／ `§ 当の特能は、下層の~platformについての情報を生成元に公開するか？＠~SECQ#underlying-platform-data$ ◎ See also: • Web Technology Accessibility Guidelines • Security and privacy are essential • What data does this specification expose to an origin?

2.12. 強力な~APIには、利用者-作動化を要求すること

一部の強力~APIは、 次に挙げる いずれかを行い得る： ◎ Some powerful APIs can＼

• 押付けな~UIを生産する （例：音声を自動-再生する） ◎ produce intrusive UI (eg. auto-playing audio),＼
• 利用者~dataを【~web~pageに】公開する （例：~clipboardとヤリトリする） ◎ expose user data (eg. interacting with the clipboard),＼
• 利用者に対する明白な指示子を伴わずに背景~活動を遂行する （例：局所~storageへ~accessする） ◎ perform a background activity without an obvious indicator to the user (eg. accessing local storage),＼
• `信用-済み~UI＠#trusted-ui$とヤリトリするよう利用者に~promptする （例：許可~prompt, 機器~hardware特能） ◎ or prompt the user to interact with trusted UI (eg. permission prompts, device hardware features).＼

これらの~APIが機能するためには、 利用者の意図nを成す何らかの指示 （`利用者-作動化^strongなど） を要求するよう設計されるベキである。 これは、 利用者が当の~web~pageに対し意図的にヤリトリしていることを指示する。 ◎ These APIs should be designed to require some indication of user intention (such as user activation) in order to function. This indicates that the user is intentionally interacting with the web page in question.

利用者-作動化は、 ~HTML標準にて，`詳細に定義される＠~HTMLinteraction#tracking-user-activation$。 利用者-作動化が生じる必要があるのは，次のうちどれになるか裁定するときは、 当の~APIによる［ 利用者~体験に対する効果，利用者に呈示される~risk ］について考するベキである ⇒＃ 合計で一回~限り（`居残な＠~HTMLinteraction#sticky-activation-gated-api$）／ 周期的（`一過な＠~HTMLinteraction#transient-activation-gated-api$）／ 各~API~callにつき一回（`一過に消費する＠~HTMLinteraction#activation-consuming-api$） ◎ User activation is defined in detail in the HTML standard. You should think about the effect your API has on the user experience, as well as any risks presented to the user, when deciding whether user activation needs to only occur once overall (sticky), periodically (transient) or once per API call (transient consuming).

利用者-作動化は、 多くの事例で必要yであるが， 侵害的な挙動から利用者を保護するに`足るとは限らない^em — `有意義な同意＠#consent$を探求することもまた重要であることに注意。 ◎ Note that while user activation is in many cases necessary, it is not always sufficient to protect users from invasive behaviours, and seeking meaningful consent is also important.

2.13. 全部的に作動中でない~BF~cacheされた文書を~supportすること

アリなら、 当の特能が ~BF~cacheされた【`~BF~cache$に格納された】`全部的に作動中$でない文書において，どう挙動するかを指定すること。 ◎ Specify how your feature behaves in non-fully active BFCached (Back/forward cached) documents if possible.

当の特能が，次に挙げるいずれかの分類に該当する`何か^strongを行う場合： ◎ If your feature does anything that falls into the following categories:

• “外側” から文書とヤリトリする （例：ある文書へ情報を送信する） ◎ Interacts with a document from the "outside" (e.g. sends information to a document)
• 文書~間での［ ヤリトリ／資源の共有 ］をアリにする （例：~lockを保持する） ◎ Makes cross-document interaction/resource sharing possible (e.g. holding locks)
• 文書が［ 利用者により他所へ~navigateされた／ 【利用者が履歴を辿った結果】復旧された ］後に［ `全部的に作動中$でない~BF~cacheされた状態 ］に保たれたとき， 当の文書は（破壊される代わりに）~~不正に機能し得る （例：当の文書~内に保存された状態は、 複数回の~naviにわたらないものと期待されている） ◎ May malfunction when a document is kept in a non-fully active BFCached state (instead of getting destroyed) after the user navigates away from it or gets restored (e.g. expects that a state saved in the document won’t span multiple navigations)

当の特能が~BF~cacheされた`全部的に作動中$でない文書でどう働くかを［ `~BF~cacheされた文書の~support法＠~BFCACHE$cite 手引きにおける指針 ］に従って指定すること。 ◎ Specify how your feature works with non-fully active BFCached documents, following the guidelines in the Supporting BFCached Documents guide.

注記： 文書は、 ~BF~cache法に関係しない他の理由で`全部的に作動中$でなくなることもアル — 当の文書を保持している `iframe$e が切離されたときなど。 この指導は、 `~BF~cache$が孕まれている事例に限られ， そのような事例には関連しない。 ◎ Note: It is possible for a document to become non-fully active for other reasons not related to BFcaching, such as when the iframe holding the document gets detached. This guidance only focuses on the case where BFCache is involved, and not other cases that might cause a document to become non-fully active.

2.14. 第三者-主体~toolとの互換性より利便性を優先すること

新たな特能を設計するときは、 第三者-主体~tool群との互換性よりも，利便性を首な目標とすること。 ◎ Design new features with usability as the primary goal, and compatibility with third-party tooling as a secondary goal.

~web~platformは、 幅広い~tool群が成す~ecosystemから，より容易かつ速い開発を手助けする便益を得ている。 今後、［ ~web~platform特能の構文が第三者-主体~toolのそれと競合して，非互換化の原因になる ］ことは，幾度となくあろう。 第三者-主体~toolは，新たな~web~platform特能の原型に利用されることが多いので、 このことは，とりわけ共通的にある。 ◎ The web platform benefits from a wide ecosystem of tooling to facilitate easier and faster development. A lot of the time, the syntax of an upcoming web platform feature may conflict with that of a third-party tool causing breakage. This is especially common as third-party tools are often used to prototype new web platform features.

~web~platform特能は、 一般に，ほとんどの第三者-主体~toolよりずっと長く残る。 なので、 それらに最適な［ 構文と機能性 ］を与える優先度は高くするべきである。 ◎ In general, web platform features last a lot longer than most third-party tools, and thus giving them the optimal syntax and functionality should be of high priority.

一部の事例では、 そのような競合は，あまりに多くの~web~siteに問題を導入する結果、 衝突を避けるため，特能の構文を設計し直す必要が生じる。 ◎ In some cases, the conflict will introduce problems across a large number of web sites, necessitating the feature’s syntax to be redesigned to avoid clashes.

しかしながら、 これらの事例は，例外とされるべきである。 ◎ However, these cases should be exceptions.

新たな構文で第三者-主体~toolを非互換化するかどうか裁定するにあたって考慮する要因は、 非互換化の著しさ, 第三者-主体~toolの普及度合いの他にも，いくつもある。 ◎ When deciding whether to break third party tools with new syntax, there are several factors to consider, such as severity of the breakage, popularity of the third party tool, and many more.

場合によっては、［ 第三者-主体~toolを非互換化するのを避けるために，当の特能の構文が変更された ］とする場合に［ ~web~platform特能の利便性は，どう著しく妥協されることになるか ］が，最も重要な要因になる。 類似な利便性を成すいくつかの代替が考慮されている場合、 通例的には，第三者-主体~toolのうち簡便でないものほど優先度を下げることが好ましい。 ◎ Possibly the most important factor is how severely would the usability of the web platform feature be compromised if its syntax was changed to avoid breaking the third party tool? If several alternatives of similar usability are being considered, it is usually preferable to prioritize the ones that inconvenience third party tools the least.

しかしながら、 第三者-主体~toolを非互換化するのを避けることが，特能の利便性に`有意^emな負な影響iへ至らす場合、 それが受容-可能な~tradeoffになることは稀にしかない — 生きた~web~siteに有意な非互換化をもたらす場合を除けば。 ◎ However, if avoiding breaking the third party tool would lead to a significant negative impact on of the feature’s usability, that is rarely an acceptable tradeoff, unless it causes significant breakage of live websites.

言語は、 将来における そのような~dilemmaを抑制するよう，作者が［ 将来の~native機能性を非互換化することなく，言語を拡張する ］ために利用できる拡張能のための仕組みも供するべきである。 ◎ Languages should also provide mechanisms for extensibility that authors can use to extend the language without breaking future native functionality, to reduce such dilemmas in the future.

2.15. 複階的な型は、より単純な型から構成することにより築くこと

下位型は、 常に，上位型の代わりとして利用できるよう定義すること。 継承を利用する~interfaceは、［ 上位型【！the parent】の~instanceについて言えるあらゆるもの ］が［ 常に下位型【！the child】にも適用される場合 ］を除いて，避けること。 ◎ Define subtypes that can always be used in place of a supertype. Avoid interfaces that use inheritance unless everything that can be said about an instance of the parent always applies to the child as well.

継承を伴う下位型は、 上位型の~item用の身代わりになれる型を作成する。 下位型は、 上位型と同じ［ 属性, ~method ］たちを供する必要がある。 下位型は、 上位型と一貫した挙動を保守する必要もある。 当の下位型が，ある~itemが働く仕方を変更する場合、 上位型を取扱う何かが適正に働かなくなるかもしれない。 ◎ With inheritance, a subtype creates a type of item that can stand in for its supertype. A subtype needs to provide the same attributes and methods as its supertype. The subtype also needs to maintain consistent behavior. If the subtype changes the way that an item works, something that handles the supertype might not work properly.

このことは、 型~systemの理論においては `Liskov の代用~原則＠https://en.wikipedia.org/wiki/Liskov_substitution_principle$ として知られる。 ◎ In the theory of type systems, this is known as the Liskov Substitution Principle.

もっと単純な~approachでは、 継承を避けて， 既存の能力を構成により再利用することが多い。 新たな~itemは、 必要な既存の成分を保持する~propを定義できる。 ◎ A simpler approach is often to avoid inheritance and reuse existing capabilities by composition. New items can define properties that hold any existing components that are needed.

3.1. 類似な機能性（のみ）を備える~HTML属性の名前を再利用すること

~HTML属性を通して指定される特能を追加している場合、 別の要素に［ 類似な機能性を指定する既存の属性~名 ］が在るかどうか検査すること。 既存の~HTML属性~名を再利用することは、 次を意味する ⇒＃ 作者は既存の知識を用立てれる／ 複数の言語にわたって`一貫性＠#consistency$を保守する／ 語彙を少なく保つ ◎ If you are adding a feature that is specified through an HTML attribute, check if there is an existing attribute name on another element that specifies similar functionality. Re-using an existing HTML attribute name means authors can utilize existing knowledge, maintains consistency across the language, and keeps its vocabulary small.

既存の~HTML属性を再利用する場合、 その構文は，当の属性の構文にアリな限り近づけるよう努めること。 ◎ If you do re-use an existing HTML attribute, try to keep its syntax as close as possible to the syntax of the existing attribute.

逆も適用される ⇒ 追加している機能性が既存の~HTML属性と`類似しない^strong場合には、 既存の~HTML属性~名を`再利用しない^strongこと。 ◎ The inverse also applies: do not re-use an existing HTML attribute name if the functionality you are adding is not similar to that of the existing attribute.

3.2. 短い~list用には~spaceで分離された値たちをとる属性を, より長い~list用には別々な要素からなる~listを利用すること

ある要素についての~metadataを［ 値たちが成す~list ］として指定するときの共通な実施は、 ~spaceで分離された~listを利用した上で， それを `DOMTokenList$I として公開することである。 ◎ When specifying metadata about an element that can be a list of values, common practice is to use a space-separated list and expose it as a DOMTokenList.

~web~platformの他の各部との一貫性は重要である — これが，［ 値どうしを別の文字を利用して分離する ］ことを意味する場合でも。 ◎ Consistency with other parts of the Web Platform is important, even if this means using another character to separate values.

構文に関わらず、 属性は，値たちが成す~listが短い場合に限り利用するベキである。 より長い~list用には、 ある属性~内に~list全体を埋込むことは忌避される。 代わりに，現在の実施は、 各~list~item（および それについての~metadata）を別々な要素を利用して表現することである。 これらの要素は、 当の要素の子~群を成すようにすることも，属性を通して~linkすることもできる。 ◎ Regardless of syntax, attributes should only be used for short lists of values. For longer lists, embedding the entire list in an attribute is discouraged. Instead, current practice is to use separate elements to represent the list items (and any metadata about them). These elements could either be children of the element in question, or linked through an attribute.

稀な~instanceにおいては、 他の~tradeoffが必要yである。 ◎ In rare instances, other tradeoffs are necessary.

3.3. ~HTML構文解析器を静止させないこと

当の設計は、 次を確保すること ⇒ ~HTML構文解析器に［ 外部~資源を取扱うために静止する ］よう要求しない。 ◎ Ensure that your design does not require HTML parser to pause to handle external resources.

~browserは，~pageを構文解析するに伴い、 当の~pageに必要な~assetを発見して，各~assetに対し［ 並列的に読込むべきかどうか，優先度を解明する ］ことになる。 そのような構文解析は、 ある資源が後続な資源の発見を阻む場合に妨害され得る。 このことは： 最悪な場合、 ~browserは［ 各~itemを並列的ではなく順番に~downloadする ］ことを意味する。 最善な場合、 ~browserは［ 投機的な構文解析に基づいて~downloadを~queueする ］ことを意味する — それは、 不正であると判明することもある。 ◎ As a page parses, the browser discovers assets that the page needs, and figures out a priority in which they should be loaded in parallel. Such parsing can be disrupted by a resource which blocks the discovery of subsequent resources. At worst, it means the browser downloads items in series rather than parallel. At best, it means the browser queues downloads based on speculative parsing, which may turn out to be incorrect.

ある特能が構文解析器を阻むのは、 一般に［ 追加的な内容を後続な内容より前に構文解析器の中へ投入したい ］と求めるからである。 旧来の `<script src="…">^c 要素の事例は、 これに該当し， `document.write(…)^c を利用して構文解析器の中へ何かを注入し得る。 上述した処理能の課題に因り、 新たな特能は，これを行なってはナラナイ。 ◎ Features that block the parser generally do so because they want to feed additional content into the parser before subsequent content. This is the case of legacy <script src="…"> elements, which can inject into the parser using document.write(…). Due to the performance issues above, new features must not do this.

3.4. 具現化を阻む特能は避けること

~pageを具現化する前に資源の読込ngや他の演算を要求する特能は、 それまで~pageが空欄に（または以前の~pageのままに）なる結果， 利用者~体験が拙くなることが多い。 ◎ Features that require resource loading or other operations before rendering the page, often result in blank page (or the previous page). The result is a poor user experience.

そのような特能の追加を考慮するのは、 利用者~体験が総合的に改善される事例に限ること。 これの正準的な例は、［ ~stylesheetを~downloadして処理するために具現化を阻む ］ことである — さもなければ、 未~styleな内容が明滅して，望ましくない利用者~体験になる。 ◎ Consider adding such features only in cases when the overall user experience is improved. A canonical example of this is blocking rendering in order to download and process a stylesheet. The alternative user experience is a flash of unstyled content, which is undesirable.

次も見よ ⇒＃ `§ 一部の~APIは専用~workerに限り公開するベキである＠#worker-only$ ◎ See also § 10.2.1 Some APIs should only be exposed to dedicated workers.

3.5. 内容~属性と~IDL属性の同期cを保つこと

新たな内容~属性には、［ 同じ名前を伴う対応する~IDL属性 ］があって，この 2 つの状態は同期するよう保たれるベキである。 同期される~IDL属性には一貫した名前を付けるベキである — さもないと作者を惑わすことになるので。 ◎ New content attributes should have a corresponding IDL attribute with the same name, and the state between the two should be kept synchronized. Carving out a synchronized IDL attribute with inconsistent naming results in confusion, and should be avoided.

注記： この逆も成立するわけではない。 新たな~IDL属性は、 常に ある内容~属性に相応するものを請合うとは限らない。 ◎ This does not hold the other way around. A new IDL attribute does not always warrant a content attribute counterpart.

3.6. ~URLを包含している属性は、首な目的に基づいて命名すること

新たな内容~属性は、［ 当の要素が，当の属性に包含される~URLへ~navigateすること ］を利用者に可能化する場合には， `href^a と命名すること — `a$e 要素の `href＠~HEmetadata#attr-link-href$a 属性の様に。 ◎ If the element enables the user to navigate to the URL contained in the attribute, call the attribute href, like the a element’s href attribute.

注記： 後の祭りだが、 `form$e の `action＠~HTMLforms#attr-fs-action$a 属性は， `href^a と命名されるベキであった。 ◎ Note: In hindsight, form’s action attribute should have been named href.

所与の~URLにある資源を当の要素に読込ませる場合には、 当の属性を `src^a と命名すること — ［ `img$e 要素の `src＠~HEimages#attr-img-src$a 属性 ／ `script$e 要素の `src＠~HEscripting#attr-script-src$a 属性 ］の様に。 ◎ If the element causes the resource at the given URL to be loaded, call the attribute src, like the img element’s src attribute or the script element’s src attribute.

注記： ~HTMLには、 旧来の，模倣されるベキでない非~一貫性がいくつかある — 例えば， `link$e 要素の `href＠~HEmetadata#attr-link-href$a 属性は、 当の要素の `rel＠~HEmetadata#attr-link-rel$a 属性の値に依存して， ~naviを許容することも, 資源の読込ngを許容することもある。 ◎ Note: HTML has a number of legacy inconsistencies that should not be emulated, like the way link’s href attribute might allow for navigation or for resource loading, depending on the value of the element’s rel attribute.

当の属性が識別する~URLが，当の要素の目的には補助的【！auxilliary】な場合、 当の属性を その意味論に従って命名すること — ［ `video$e の `poster＠~HEmedia#attr-video-poster$a ／ `q$e の `cite＠~HEtextlevel#attr-q-cite$a ／ `a$e の `ping＠~HTMLlinks#ping$a ］の様に。 ◎ If the attribute identifies a URL that is auxilliary to the element’s purpose, like video’s poster, q’s cite, or a’s ping, name the attribute after its semantics.

注記： ~URLを包含している属性は、 ~IDLにおいては `USVString$c として表現するベキであることにも留意すること — `§ 文字列を適切に表現すること＠#idl-string-types$を見よ。 ◎ Note: remember that attributes containing URLs should be represented in IDL as USVString; see § 8.2 Represent strings appropriately.

3.7. 各~HTML要素に与える目的は一つに限ること

各~HTML要素には、 明瞭な目的を有するべきである。 要素の意味論は，各種~HTML属性を利用して改変できるが、 属性は，要素の目的を根本的に改めるべきではない。 ◎ Each HTML element should have a clear purpose. Using HTML attributes can modify the semantics of an element, but attributes should not fundamentally alter that purpose.

【 この節における “要素” は、 要素~型を意味する — 個々の要素ではなく。 】

要素を各種~modeで演算できるよう定義するよりも， 各~mode用に別々な要素がある方が好ましい。 このことは、 作者にとっても用法を単純~化する。 ◎ Rather than defining elements that can operate in different modes, having a separate element for each mode is preferable. This simplifies usage for authors.

同じ要素に対し，属性たちの利用を通して意味論を多重定義することは、 各種~挙動から一つを選定するためにも利用できる。 これは、［ 当の属性たちの値が何であれ，目的は同じであり続ける所 ］に限り，イミを成す。 ◎ Overloading of semantics on the same element through the use of attributes could be used to select between different behavior. This only makes sense where the purpose remains the same for any value of the attributes.

反例になり得るものとして、［ 特化され過ぎた要素, 文脈に依拠して自身の意味論を確立する要素 ］が挙げられる。 ◎ Potential counterexamples include overspecialization and elements that rely on context to establish their semantics.

4.1. ~CSS~propは、何が別々に~cascadeされるべきかに基づいて分離すること

~CSS~propの値として，どれを一緒に~group化して どれを分離するべきかは、 何を独立に設定すればイミを成すかに基づいて裁定すること。 ◎ Decide which values should be grouped together as CSS properties and which should be separate properties based on what makes sense to set independently.

`~CSS~cascade法＠~CASCADE#cascading$【！~TR/2011/REC-CSS2-20110607/cascade.html#cascade】は、 ~CSS［ 規則／~stylesheet ］に属する`~CSS宣言＠~CSSOM1#css-declaration$【！~TR/2011/REC-CSS2-20110607/syndata.html#declaration】が別のそれを上書きすることを許容する。 一緒に上書きされるべき値たちが成す集合は、 一緒に~cascadeするよう，単独の~prop内に一緒に~group化されるべきである。 同様に，独立に上書き可能になるべき各~値は、 別々な~propに分けられるべきである。 ◎ CSS cascading allows declarations from different rules or different style sheets to override one another. A set of values that should all be overridden together should be grouped together in a single property so that they cascade together. Likewise, values that should be able to be overridden independently should be separate properties.

4.2. ~CSS~propが継承されるかどうかについて適切な選択を為すこと

ある~propが`継承-$されるべきかどうかは、 次に基づいて裁定すること ⇒ ~propによる効果は、 同じ~propが当の要素の ある先祖や子孫に設定された場合に［ 上書きされる／追加される ］どちらになるべきか。 ◎ Decide whether a property should be inherited based on whether the effect of the property should be overridden or added to if set on an ancestor as well as a descendant.

~propを要素に設定することによる効果が，要素の先祖に設定することによる効果 ⇒＃ を上書きする必要がある場合、当の~propは，おそらく継承されるべきである／ とは別々な効果を追加する場合、当の~propは，おそらく`継承されない^strongべきである ◎ If setting the property on a descendant element needs to override (rather than add to) the effect of setting it on an ancestor, then the property should probably be inherited. ◎ If setting the property on a descendant element is a separate effect that adds to setting it on an ancestor, then the property should probably not be inherited.

継承されない~propの仕様が，要素に対し［ 先祖の同じ~propの値を調べる取扱い ］を要求している場合（それは、遅くもなり得る）、［ 当の~propは，およそ継承されるべきであった ］ことを示唆する “~code臭（ `code smell^en, ~~兆候）” である。 継承される~propの仕様が，要素に対し［ ~propの値が要素の親の同じ~propの値と同じになる場合には，~propを無視する取扱い ］を要求している場合、［ 当の~propは，およそ継承されるべきでなかった ］ことを示唆する “~code臭” である。 ◎ A specification of an non-inherited property requiring that the handling of an element look at the value of that property on its ancestors (which may also be slow) is a "code smell" that suggests that the property likely should have been inherited. A specification of an inherited property requiring that the handling of an element ignore the value of a property if it’s the same as the value on the parent element is a "code smell" that suggests that the property likely should not have been inherited.

注記： ~textに対し効果がある~propは、 ほぼ常に［ 要素に設定することによる効果は、 要素の先祖に設定することによる効果を（追加するのではなく）上書きする必要がある ］ので，継承されるべきである。 これはまた、 次の設計~原則を保守するためにも必要になる ⇒ ~text片の周りに~styleを伴わない行内~要素を挿入しても 【~text片を`行内~box＠~CSSDISP#inline-box$を生成する要素で包装しても】， その~textの外観は変化しない。 ◎ If a property has an effect on text, then it’s almost always true that a descendant element needs to override (rather than add to) the effect of setting it on an ancestor, and the property should be inherited. This is also needed to maintain the design principle that inserting an unstyled inline element around a piece of text doesn’t change the appearance of that text.

4.3. 算出d値の型は、~propがどう継承されるべきかに基づいて選ぶこと

~CSS~propの`算出d値$は、［ 当の~propは、 値をどう`継承-$することになるか ］に基づいて選ぶこと — ［ 値が他の~propに依存する所では、 どう継承されるべきか ］も含めて。 ◎ Choose the computed value of a CSS property based on how it will inherit, including how values where it depends on other properties should inherit.

所与の~propの継承は、 次を意味する ⇒ 要素の［ 当の~prop ］の`算出d値$は、 要素の親の［ 当の~prop ］の`算出d値$から取得される — このことは、 次を意味する ⇒ 処理~手続きのうち，`算出d値$に到達するより ⇒＃ 前に起こるものは、`継承d値$に影響する／ 後に起こるもの（`使用~値$用のものなど）は、`継承d値$に影響しない ◎ Inheritance means that an element gets the same computed value for a property that its parent has. This means that processing steps that happen before reaching the computed value affect the value that is inherited, and those that happen after (such as for the used value) do not.

注記： `算出d値$と`解決d値$を混同するべきでない — 後者は、 `getComputedStyle()＠~CSSOM1#dom-window-getcomputedstyle$c ~methodが返す値である。 ◎ Note: the computed value should not be confused with the resolved value which is returned from the getComputedStyle() method.

<body style="font-size: 20px; line-height: 1.4">

  <p>
`body^e 内の この~textの行l高さは、
`28px^v になる。
◎
This body text has a line height of 28px.
</p>

  <h2 style="font-size: 200%">

`line-height^p は `body^e に宣言されているが、
この見出しの `line-height^p の使用~値は，
`28px^v ではなく `56px^v になる。
すなわち、
~font~sizeが `40px^v になろうが，行l高さを~overflowしない。
◎
This heading has a line-height of 56px, not 28px, even though the line-height was declared on the body. This means that the 40px font won’t overflow the line height.

  </h2>
</body>

次も見よ ⇒ `算出d値の~pattern＠https://wiki.csswg.org/spec/computed-values$ ◎ See also: • Computed Values Patterns

4.4. ~CSS~propとその値を適切に命名すること

~CSS~propの名前は，通例的に名詞であり、 それらの値の名前は，通例的に形容詞である（名詞のときもあるが）。 ◎ The names of CSS properties are usually nouns, and the names of their values are usually adjectives (although sometimes nouns).

［ ~prop／その値 ］を成す各~単語は、 ~hyphenで分離される。 一般に，略語は避けられる。 ◎ Words in properties and values are separated by hyphens. Abbreviations are generally avoided.

アリなときは単語の語根を利用すること — 文法~上の［ 接頭辞や接尾辞 ］を伴う形ではなく（例えば， `sizing^l ではなく `size^l ）。 ◎ Use the root form of words when possible rather than a form with a grammatical prefix or suffix (for example, "size" rather than "sizing").

~prop用の値たちが成す~listは、 一般に，新たな値を追加できるように選ぶべきである — 次に挙げる様な値は、 避けること ⇒ ［ `yes^v, `no^v, `true^v, `false^v ］, あるいは、 基本的にこれらと等価な，より複階的な名前を伴うもの ◎ The list of values of a property should generally be chosen so that new values can be added. Avoid values like yes, no, true, false, or things with more complex names that are basically equivalent to them.

~propの名前においては、［ "`mode^en"（~mode）, "`state^en"（状態） ］の様な単語は避けること — ~propは、 一般に［ ~mode／状態 ］を設定するものなので。 ◎ Avoid words like "mode" or "state" in the names of properties, since properties are generally setting a mode or state.

命名に対する一般的な（各種~言語にわたる）助言は、 `§ 命名~原則＠#naming-is-hard$ を見よ。 ◎ See § 12 Naming principles for general (cross-language) advice on naming.

4.5. 内容は既定で~view可能かつ~access可能になるべきである

~CSS~prop, および~CSS~layout~systemは （それらは概して， `display$p ~propの値【で指定される】）、 次を保全するように設計すること ⇒ 内容は、 既定では［ ~view可能, ~access可能, 利用-可能 ］になる ◎ Design CSS properties or CSS layout systems (which are typically values of the display property), to preserve the content as viewable, accessible and usable by default.

5.1. ~Web~APIには~JSを利用すること

~Web用に命令的な~APIを設計するときは、 ~JSを利用すること。 特に、 【多数の言語に】一般~化する必要はなく，【~JS】言語に特有な［ 意味論／規約 ］に自由に依拠できる。 ◎ When designing imperative APIs for the Web, use JavaScript. In particular, you can freely rely upon language-specific semantics and conventions, with no need to keep things generalized.

注記： ~JSは、 名前 `ECMASCRIPT$r の下で標準~化されている。 ◎ JavaScript is standardized under the name [ECMASCRIPT].

注記： `WEBIDL$r は，別々な “§ ~ES言語束縛” を定義するが、 それは［ ~Web~IDLは、 他の~programming言語における言語束縛も備えることを意図する ］ことは含意しない。 ◎ [WEBIDL] defines a separate "ECMAScript binding" section, but this doesn’t imply that Web IDL is intended to have bindings in other programming languages.

5.2. 完了まで走る（ `run-to-completion^en ）意味論を保全すること

状態に対する変更が，~JS実行~文脈の外側に~~起因する場合、 その変化は，各~taskの合間に~JSへ伝播する — 例えば、 `~taskを~queueする＠~WAPI#queuing-tasks$ことにより／ `描画の更新＠~WAPI#update-the-rendering$を成す一部として。 ◎ If a change to state originates outside of the JavaScript execution context, propagate that change to JavaScript between tasks, for example by queuing a task, or as part of update the rendering.

C++ や Rust などの低~levelな言語と違って，~JSは、 歴史的に，一度に一つの~code片しか実行し得ないかのように動作してきた。 そのことから、 ~JS作者は，次を当然のことと~~見なす ⇒ ある関数にて可用にされた~dataは、 当の関数が走っている間に予期せず変化することはない。 ◎ Unlike lower-level languages such as C++ or Rust, JavaScript has historically acted as if only one piece of code can execute at once. Because of that, JavaScript authors take for granted that the data available to a function won’t change unexpectedly while the function is running.

［ 開発者による動作の結果でない変化／ 非同期に送達される変化 ］は、 他の~JSの途中 — `小task$たちの合間も含む — で起こるベキでない。 ◎ Changes that are not the result of developer action and changes that are asynchronously delivered should not happen in the middle of other JavaScript, including between microtasks.

~dataは、 開発者による動作の結果としては，同期的に更新できる。 ◎ Data can update synchronously from the result of developer action.

少数ながら，この規則に違反することを正当化する状況もある： ◎ A few kinds of situations justify violating this rule:

• 現在の時刻を観測すること — `Date.now()＠~TC39M/numbers-and-dates.html#sec-date.now$c や `performance.now()＠~HRTIME#dom-performance-now$c のように。 が、 各~task間で一貫した時刻を呈示することも，有用になることに注意 — `document.timeline.currentTime＠~WANIMapi#dom-animationtimeline-currenttime$c のように。 ◎ Observing the current time, as in Date.now() and performance.now(), although note that it’s also useful to present a consistent task-wide time as in document.timeline.currentTime.
• 開発者が【自身による】同期的な作業を中断する助けになることが意味される関数 — `IdleDeadline$I の `timeRemaining()＠~REQUESTIDLECALLBACK#dom-idledeadline-timeremaining$c のように。 ◎ Functions meant to help developers interrupt synchronous work, as in the case of IdleDeadline.timeRemaining().
• 利用者を思いがけない~UI変化から保護することが意味される状態 — `一過な作動化＠~HTMLinteraction#transient-activation$の様な。 `navigator.userActivation.isActive＠~HTMLinteraction#dom-useractivation-isactive$c は、 `この事例には~methodを推奨する指導＠#attributes-like-data$に違反することに注意。 ◎ States meant to protect users from surprising UI changes, like transient activation. Note that navigator.userActivation.isActive violates the guidance that recommends a method for this case.

5.3. ~garbage収集を公開しないこと

当の~JS~Web~APIは、 次を確保すること ⇒ ~garbage収集の時機を知る仕方を作者に供さない ◎ Ensure your JavaScript Web APIs don’t provide a way for an author to know the timing of garbage collection.

~garbage収集の時機は，~UAごとに異なることに加え、 ~UAが処理能を改善する作業に伴い，時を経て変化することもある。 ある~APIが~garbage収集の時機を公開した場合、 ~programの挙動が文脈に応じて異なる原因になり得る。 これは、 作者が これらの相違点を取扱うために加的な~codeを書する必要があることを意味する。 また，時機に依存するような特定0の仕方で働く~codeが~~普及すると、 ~UAは異なる~garbage収集~策を実装するのが困難になり得る。 ◎ The timing of garbage collection is different in different user agents, and may change over time as user agents work on improving performance. If an API exposes the timing of garbage collection, it can cause programs to behave differently in different contexts. This means that authors need to write extra code to handle these differences. It may also make it more difficult for user agents to implement different garbage collection strategies, if there is enough code which depends on timing working a particular way.

このことは、 弱い参照として動作する~API — 例： ~garbage収集が走ったなら ~NULL になるような~prop — は，公開するべきでないことを意味する。 ~JS~codeにおける［ ~obj／~data ］の存続期間は予測-可能になるべきである。 ◎ This means that you shouldn’t expose any API that acts as a weak reference, e.g. with a property that becomes null once garbage collection runs. Object and data lifetimes in JavaScript code should be predictable.

`getElementsByTagName()$c は、 ~garbage収集の時機に依存し得ることについて何も告げない。 対照的に［ `WeakRef＠~TC39M/managing-memory.html#sec-weak-ref-objects$jT ／ `FinalizationRegistry＠~TC39M/managing-memory.html#sec-finalization-registry-objects$jT ］の様な，~garbage収集に依存するよう明示的に設計された~APIは、［ ~garbage収集との相互作用についての作者の期待 ］に正確aに沿うよう設定されている。 ◎ getElementsByTagName gives no sign that it may depend on the timing of garbage collection. In contrast, APIs which are explicitly designed to depend on garbage collection, like WeakRef or FinalizationRegistry, set accurate author expectations about the interaction with garbage collection.

6.1. 属性は~data~propの様に挙動するべきである

~IDL属性 `WEBIDL$r は、 単純な~JS~obj~propの様に動作するべきである。 ◎ [WEBIDL] attributes should act like simple JavaScript object properties.

現実においては、 ~IDL属性は，別々な［ 取得子, 設定子 ］~methodを伴う，~accessor~propとして実装される。 それらが~JS~obj~prop様に動作するためには： ◎ In reality, IDL attributes are implemented as accessor properties with separate getter and setter methods. To make them act like JavaScript object properties:

• 取得子は、 観測-可能な副作用を伴ってはナラナイ。 ◎ Getters must not have any observable side effects.
• 取得子は、 複階的な演算を遂行するべきでない。 ◎ Getters should not perform any complex operations.
• `obj.attribute === obj.attribute^c が常に ~T になることを確保すること。 取得子が~callされる回ごとに新たな値を作成しないこと。 ◎ Ensure that obj.attribute === obj.attribute is always true. Don’t create a new value each time the getter is called.
• アリなら、 obj.attribute = %x に~~後続する obj.attribute === %x は， ~T に評価されることを確保すること。 （ %x に対し何らかの種類の変換が必要yな場合、 これはアリでないこともある。） ◎ If possible, ensure that given obj.attribute = x, obj.attribute === x is true. (This may not be possible if some kind of conversion is necessary for x.)

ある属性を利用していて，この仕方で挙動しないことについて考している場合、 おそらく，代わりに~methodを利用するべきである。 ◎ If you were thinking about using an attribute, but it doesn’t behave this way, you should probably use a method instead.

6.2. ~objは~liveか静的どちらになるべきか考慮すること

~APIが何らかの内部~状態を表現している~objへの~accessを与える場合、［ 当の~objは，当の状態が変化するに伴い更新され続けるべきである ］かどうかを裁定すること。 ◎ If an API gives access to an object representing some internal state, decide whether that object should continue to be updated as the state changes.

~objのうち，いつの時点でも現在の状態を表現するものは `~live~obj@ である一方、 作成された時点の状態を表現するものは `静的~obj@ である。 ◎ An object which represents the current state at all times is a live object, while an object which represents the state at the time it was created is a static object.

let %list = document.getElementsByTagName("td");

for (let %i = 0; %i < %list.length; %i++) {
    let %td = %list[%i];
    let %tr = document.createElement("tr");
    %tr.innerHTML = %td.outerHTML;

    /* 
これには %list から `td^e 除去する副作用があり、
反復を予測-不能にする。
◎
This has the side-effect of removing td from the list, causing the iteration to become unpredictable.
 */
    %td.parentNode.replaceChild(%tr, %td);
}

6.3. ~accessorは、~methodではなく~propの様に挙動するべきである

~objの［ ~prop／取得子 ］を述べる~IDL属性は、 ~objの状態について情報を生産する。 ◎ IDL attributes that describe object properties or getters produce information about the state of an object.

• 取得子は、 （観測-可能な）副作用を伴ってはナラナイ。 副作用が予期される場合、 ~methodを利用すること。 ◎ A getter must not have any (observable) side effects. If you have expected side effects, use a method.

• 取得子は、 例外を投出するベキでない： ◎ Getters should not throw exceptions.＼

  • 取得子は、 `~data~propの様に挙動するべきである＠#attributes-like-data$ — 定例の~data~propが読取られるときは、 例外を投出するべきでない。 ◎ Getters should behave like regular data properties, and regular data properties do not throw exceptions when read.＼
  • 妥当でない状態は、 一般に~dataの書込nを却下することにより，避けるベキである — `読取られる^emときではなく。 ◎ Furthermore, invalid state should generally be avoided by rejecting writes, not when data is read.＼
  • 既存の取得子を例外を投出するよう更新することは、 避けるベキである。 既存の~APIの利用者は、 当の~API【の各~取得子の結果】を［ 列挙する／包装する ］こともあり，新たな例外を予期しないので、 そうすると，後方-互換性を非互換化することになる。 ◎ Updating existing getters to throw exceptions should be avoided as existing API users may enumerate or wrap the API and not expect the new exception, breaking backwards compatibility.
• 取得子は、 他を阻む演算を遂行するベキでない。 ある取得子が，他を阻む演算を遂行することを要求する場合、 ~methodにするベキである。 ◎ Getters should not perform any blocking operations. If a getter requires performing a blocking operation, it should be a method.
• 取得子は、 下層の~objが変化するまでの間は，~callされる回ごとに同じ~objを返すべきである。 すなわち、 常に `obj.property === obj.property^c が満たされなければならない。 取得子から毎回~新たな値を返すのは許容されない。 これを満たせない取得子は、 ~methodにするべきである。 ◎ If the underlying object has not changed, getters should return the same object each time it is called. This means obj.property === obj.property must always hold. Returning a new value from an getter each time is not allowed. If this does not hold, the getter should be a method.

注記： 他を阻む演算を伴う~antipatternの例は、 `offsetTop＠~CSSOMVIEW#dom-htmlelement-offsettop$c の様な~layoutを遂行する取得子である。 ◎ Note: An antipattern example of a blocking operation is with getters like offsetTop performing layout.

~IDL属性を定義するときは、 アリなときは，その設定子に与えられた値を取得子から返すために保全すること。 すなわち、 obj.property = %x に~~後続する obj.property === %x は， ~T に評価されるべきである （このことは — 例えば，正規化や型~変換の段が必要yな場合など — 常に該当するとは限らないが、 通常の~code~path用には， 目標として保持されるべきである。） ◎ When defining IDL attributes, whenever possible, preserve values given to the setter for return from the getter. That is, given obj.property = x, a subsequent obj.property === x should be true. (This will not always be the case, e.g., if a normalization or type conversion step is necessary, but should be held as a goal for normal code paths.)

`~liveな~obj, 静的な~obj＠#live-vs-static$ どちらを返すことも求まれ得る。 このことは、 次を意味する： ◎ The object you want to return may be live or static. This means:

• ~liveである場合、 毎回~同じ~objを返すこと — ある状態~変化により，異なる~objを返すよう要求されるまでは。 ［ ~prop, 取得子, ~method ］は、 いずれも，これを返し得る。 ◎ If live, then return the same object each time, until a state change requires a different object to be returned. This can be returned from either a property, getter, or method.
• 静的な場合、 毎回~新たな~objを返すこと。 この事例は、 ~methodに限られるべきである。 ◎ If static, then return a new object each time. In which case, this should be be a method.

6.4. 省略可能な／~primitiveな引数は辞書を通して受容すること

~API~methodは、 一般に，一連の省略可能な引数の代わりに`辞書$引数を利用するべきである。 ◎ API methods should generally use dictionary arguments instead of a series of optional arguments.

そうすれば、 当の~methodを~callする~codeは より可読になり， ~methodの~signatureも覚え易くなる。 また、 将来に当の~APIを より拡張-可能にする — 特に，同じ型を伴う複数個の引数が必要になる場合に。 ◎ This makes the code that calls the method more readable, and the method signature easier to remember. It also makes the API more extensible in the future, particularly if multiple arguments with the same type are needed.

new Event("example", { bubbles: true, cancelable: false})

new Event("example", true, false)

義務的な~parameterを辞書を通して受容することも — そうした方が，当の~APIが可読になるなら — 考慮するベキである — とりわけ、 それらが~primitive型であるときは。 ◎ You should also consider accepting mandatory parameters through a dictionary, if it would make the API more readable, especially when they are of primitive types.

window.scrollBy({ left: 50, top: 0 })

window.scrollBy(50, 0)

当の`辞書$自身は、 省略可能な引数にするべきである — 作者が すべて既定の~optionで~~満足な場合、 余分な引数を渡さなくとも済むよう。 ◎ The dictionary itself should be an optional argument, so that if the author is happy with all of the default options, they can avoid passing an extra argument.

%element.scrollIntoView(false, {});

%element.scrollIntoView(false);

次も見よ ⇒＃ `Hall of API Shame:Boolean Trap＠https://ariya.io/2011/08/hall-of-api-shame-boolean-trap$en（ “真偽値の罠” ）／ `§ ~methodの引数は、アリなら省略可能にすること＠#optional-parameters$／ `§ 省略可能な引数を適切に命名すること＠#naming-optional-parameters$ ◎ See also: • Hall of API Shame: Boolean Trap. • § 6.5 Make method arguments optional if possible • § 6.6 Name optional arguments appropriately

6.5. ~methodの引数は、アリなら省略可能にすること

~API~method用の ある引数に適理な既定の値がある場合、 その引数を省略可能にして，既定の値を指定すること。 ◎ If an argument for an API method has a reasonable default value, make that argument optional and specify the default value.

真偽値をとる引数~用には、 既定の値は ~F になることが強く選好される。 ◎ For boolean arguments, a default value of false is strongly preferred.

既定の値は、 ほとんどの作者が選ぶことになる値が明白ならば，それになるべきである。 真偽-属性~用には、［ 当の属性の名前は，共通的な選択が ~F になるよう選ばれる必要がある ］ことを意味するかもしれない。 ◎ The default value should be the value that most authors will choose, if that choice is obvious. For boolean attributes, that might mean that the attribute name needs to be chosen so that false is the common choice.

当の~APIに用いる~list~data型を裁定するときは、 他が要求されない限り，次に挙げる~list型を利用すること： ◎ When deciding between different list data types for your API, unless otherwise required, use the following list types:

• ~methodの~list引数は、 `連列~型$になるべきである。 ◎ Method list arguments should be of type sequence<T>
• ~methodの返り値は、 `連列~型$になるべきである。 ◎ Method return values should be of type sequence<T>
• 属性は、 `観測-可能な配列~型$になるべきである。 ◎ Attributes should be of type ObservableArray<T>

次も見よ ⇒＃ `§ 省略可能な／~primitiveな引数は辞書を通して受容すること＠#prefer-dictionaries$／ `§ 省略可能な引数を適切に命名すること＠#naming-optional-parameters$／ `真偽値~引数が既定で ~T になる~API＠https://lists.w3.org/Archives/Public/public-script-coord/2013OctDec/0302.html$ ◎ See also: • § 6.4 Accept optional and/or primitive arguments through dictionaries • § 6.6 Name optional arguments appropriately • APIs that have boolean arguments defaulting to true

6.6. 省略可能な引数を適切に命名すること

省略可能な引数は、 否定的な名前にしないで，既定の挙動が明白になるよう命名すること。 ◎ Name optional arguments to make the default behavior obvious without being named negatively.

これは、 `辞書~内に供される＠#prefer-dictionaries$ときも, `単独の引数として供される＠#optional-parameters$ときも適用される。 ◎ This applies whether they are provided in a dictionary or as single arguments.

次も見よ ⇒ `§ 命名~原則＠#naming-is-hard$ ◎ See also: • § 12 Naming principles

6.7. 多重定義を賢く利用すること

ある~methodの挙動が，渡された引数に依存して有意に異なることになる場合、 通例的には，別々な~methodを定義するベキである — 単独の~methodを`多重定義-$するのでなく。 ◎ If the behaviour of a method will be significantly different depending on the arguments passed you should usually define a separate method rather than overload a single method.

~methodの多重定義は、 いずれかの引数が［ 1 個の値, 値たちが成す配列 ］どちらもとり得るときなどに有用になる。 類似に，~optionたちが成す辞書を渡すことは、 より柔軟性を許容するので，良い~patternである。 ◎ Overloading a method such that one of its arguments can be either a single value or an array of values is useful. Similarly, passing a dictionary of options is a good pattern because it allows for more flexibility.

しかしながら，ある~methodにおいて［ 渡された最初の引数に応じて後続な引数を変更する必要がある場合 ］や［ 各~入力の型に依存して挙動が異なる場合 ］には、 多重定義を避けるベキである — ~codeの可読性を邪魔して， 作者が~APIの機能性を発見するのが困難になり得るので。 ◎ However, if subsequent arguments for a method have to change because of the first argument passed, or if a method has different behaviour depending on the types of inputs, this can hinder code readability, and make discovering API functionality more difficult for authors, and should be avoided.

6.8. ~classは、アリなときは，構築子を備えるべきである

当の~APIの一部を成す~classは、 適切になるなら，構築子を備えるようにすること。 ◎ Make sure that any class that’s part of your API has a constructor, if appropriate.

`WEBIDL$r ~interfaceは，既定では “構築-可能でない” ~classを生成するので、 それらの~instanceを `new X()^c を利用して作成しようと試行すると， `TypeError$E を投出することになる。 それらは、 次により構築-可能にできる ⇒ 当の~interfaceに適切な`構築子~演算$を追加して， 当の~classの新たな~instanceを作成する~algoを定義する ◎ By default, [WEBIDL] interfaces generate "non-constructible" classes: trying to create instances of them using new X() will throw a TypeError. To make them constructible, you can add appropriate constructor operations to your interface, and defining the algorithm for creating new instances of your class.

これは、［［ 当の~classの~instanceを受容する第三者-主体~library ］とともに［ ~testする／模擬する／~interfaceする ］などの目的で，~classの~instanceを作成すること ］を，~JS開発者に許容する。 それは、 当の~classの下位classを作成する能も作者に与える — 無い場合、 そのような能は，~JSが下位classを取扱う仕方により防止される。 ◎ This allows JavaScript developers to create instances of the class for purposes such as testing, mocking, or interfacing with third-party libraries which accept instances of that class. It also gives authors the ability to create a subclass of the class, which is otherwise prevented, because of the way JavaScript handles subclasses.

これが適切にならない事例もある — 例えば： ◎ This won’t be appropriate in all cases. For example:

• 一部の~objは，特権的な資源への~accessを表現するので、 そのような資源へ~accessできる~factory~methodにより構築される必要がある。 ◎ Some objects represent access to privileged resources, so they need to be constructed by factory methods which can access those resources.
• 一部の~objは，その~lifecycleがとても注意深く制御されるので、 特定の~methodを通して作成され, ~accessされる必要がある。 ◎ Some objects have very carefully controlled lifecycles, so they need to be created and accessed through specific methods.
• 一部の~objは，抽象-基底~classを表現するので、 構築されるべきでなく，作者は それ用の下位classを定義-可能になるべきでない。 ◎ Some objects represent an abstract base class, which shouldn’t be constructed, and which authors should not be able to define subclasses for.

~factory~methodは，構築子を補うものになり得るが、 一般に，構築子の`代わり^emとして利用されるべきでない。 それでも，構築子に加えて~factory~methodを含めることは、 追加的な便益を供するなら価値をもたらし得る。 そのような共通的な事例は、 ~APIが ある基底~class, 複数個の特化された下位classを含んでいて，［ 渡された~parameterに基づいて適切な下位classを作成する ］ための~factory~methodを伴うときである。 ~factory~methodは、［ 返される結果に共通かつ最も近い基底~下位class ］上の静的~methodになることが多い。 ◎ Factory methods can complement constructors, but generally should not be used instead of them. It may still be valuable to include factory methods in addition to constructors, when they provide additional benefits. A common such case is when an API includes base classes and multiple specialized subclasses, with a factory method for creating the appropriate subclass based on the parameters passed. Often the factory method is a static method on the closest common base subclass of the returned result.

6.9. 適切なときは同期的にすること

新たな~APIを設計するときは、 アリな所では，同期的な~APIを選好すること。 同期的な~APIを利用する方が単純であり、 設定しておく必要な基盤（関数を `async^c にするなど）も少なくなる。 ◎ Where possible, prefer synchronous APIs when designing a new API. Synchronous APIs are simpler to use, and need less infrastructure set-up (such as making functions async).

一般に~APIは、 次に挙げる~~経験則が適用される場合には，同期的にするべきである： ◎ An API should generally be synchronous if the following rules of thumb apply:

• ~APIは、 許可~promptや装置~選定器などの~dialogの背後で通過制御されるものと期待されてはいない。 ◎ The API is not expected to ever be gated behind a permission prompt, or another dialog such as a device selector.
• ~APIの実装は、［ ~lock／~filesystem／~network~access ］ — 例えば，~process間の通信 — により阻止されない。 ◎ The API implementation will not be blocked by a lock, filesystem or network access, for example, inter-process communication.
• 実行~時間は、 短くかつ決定的である。 ◎ The execution time is short and deterministic.

6.10. 非同期的な~APIは~Promiseを利用して設計すること

~API~methodを非同期的にする必要がある場合、 ~callback関数ではなく，~Promiseを利用すること。 ◎ If an API method needs to be asynchronous, use Promises, not callback functions.

~web~platform~~全般に一貫して~Promiseを利用することは、 ~promiseを連鎖するなど，~APIを他と一緒に利用するのも より容易になることを意味する。 また，~promiseを利用している~codeの方が、 ~callback関数を利用している~codeより容易に理解できる傾向にある。 ◎ Using Promises consistently across the web platform means that APIs are easier to use together, such as by chaining promises. Promise-using code also tends to be easier to understand than code using callback functions.

次のいずれかに該当する場合、 ~APIは非同期的にする必要があるかもしれない： ◎ An API might need to be asynchronous if:

• ~UAは利用者に `許可＠#consent$ を~promptする必要があるとき。 ◎ the user agent needs to prompt the user for permission,
• 何らかの情報を［ ~diskから読取る／~networkへ要請する ］必要があるかもしれないとき。 ◎ some information might need to be read from disk, or requested from the network,
• ~UAは、 結果を返す前に別の［ ~thread上で／~process内で ］有意な量の作業を行う必要もあるとき。 ◎ the user agent may need to do a significant amount of work on another thread, or in another process, before returning the result.

次も見よ ⇒ `~Promiseを利用する仕様の書法＠~PROMISES$ ◎ See also: • Writing Promise-Using Specifications

6.11. 非同期的な~APIや演算を取消すときは `AbortSignal^I を利用すること

非同期的な~methodが取消され得る場合、［ ~option群を成す`辞書$の一部として `AbortSignal$I を渡す ］ことを作者に許容すること。 ◎ If an asynchronous method can be cancelled, allow authors to pass in an AbortSignal as part of an options dictionary.

const %controller = new AbortController();
const %signal = %controller.signal;
geolocation.read({ %signal });

非同期的な演算を取消す仕方として， `AbortSignal^I を一貫して利用すれば、 作者は，~codeをもっと単純に書せるようになる。 ◎ Using AbortSignal consistently as the way to cancel an asynchronous operation means that authors can write less complex code.

例えば，次のような~patternがある ⇒ 同じ `AbortSignal^I を何個かの進行中な演算に利用した上で，必要yな場合は （利用者から取消すよう要請されたときや，単-~page~appにおいて~naviが生じたときなど）、 対応する `AbortController$I を利用して，すべての演算を まとめて取消すなど。 ◎ For example, there’s a pattern of using a single AbortSignal for several ongoing operations, and then using the corresponding AbortController to cancel all of the operations at once if necessary (such as if the user presses "cancel", or a single-page app navigation occurs.)

`AbortController$I は、 取消nが保証できない場合でも利用できる — その `abort()＠~DOM4#dom-abortcontroller-abort$c ~methodの~callは、 保証ではなく要請なので。 ◎ Even if cancellation can’t be guaranteed, you can still use an AbortController, because a call to abort() on AbortController is a request, rather than a guarantee.

6.12. 定数や列挙d値には文字列を利用すること

［ 定数／列挙d値たちが成す集合 ］には、 文字列~値を利用すること。 ◎ Use strings as the values for constants or sets of enumerated values.

文字列の方が，開発者にとって検分するのは容易になる。 ~JS~engineにおいても，文字列の代わりに整数を利用しても処理能の便益は無い。 ~Web~IDL`列挙~型$は、 この原則に従うため，文字列を値にとる。 ◎ Strings make it easier for developers to inspect values and read code that uses those values. In JavaScript engines there is no performance benefit to using integers instead of strings. The values of a WebIDL enum type are strings in order to follow this principle.

状態を~propの組合nで表出する必要がある場合、 代わりに辞書~objを利用すること — 別の言語では、 ~bitmaskとして表出されることもあろうが。 この~objは、 単独の~bitmask値と同じくらい容易に受け渡せる。 ◎ If you need to express a state which is a combination of properties, which might be expressed as a bitmask in another language, use a dictionary object instead. This object can be passed around as easily as a single bitmask value.

6.13. 非同期的, 同期的どちらの~methodも必要な場合、同期的な方を例外とすること

稀な事例では、 同じ目的に［ 同期的, 非同期的 ］どちらの~methodも必要になる — その場合、 非同期的な方を既定として，同期的な方は例外とすること。 ◎ In the rare case where you need to have both synchronous and asynchronous methods for the same purpose, default to asynchronous and make synchronous the exception.

~web~platformの一部を成す特定の分野は、 現在の制限に因り，非同期的な~supportを欠いている。 したがって、［ 非同期的な~methodに加えて，同期的な~method用の~supportを備える ］ことは，利便性に有益になり得る。 これらの事例は例外であり、 同期的な~methodは，~web~platformの能力が発展するに伴って非推奨にされる明瞭な道があると見なすこと。 ◎ Due to current limitations, some specific areas of the web platform lack asynchronous support. Therefore having support for synchronous methods in addition to asynchronous methods can be beneficial for usability. Consider these cases an exception, and have a clear path for deprecation of the synchronous methods as web platform capabilities evolve.

ほとんどの事例では、 同期的な変種は， `Sync()^c 接尾辞を伴うよう命名することにより判別されるベキである。 ◎ For most cases, the synchronous variant should be distinguished by naming it with a Sync() suffix.

注記： 現時点で，これが適用-可能な周知な事例として， ~JSと~WASMの境界をまたぐ設計が挙げられる — 現今では、 `Promise integration＠https://github.com/WebAssembly/js-promise-integration/blob/main/proposals/js-promise-integration/Overview.md$cite （~promiseの統合）は，依然として開発~下にあるので。 ◎ At the moment, one well-known case where this is applicable is when a design has to cross boundaries between JavaScript and WASM, as the Promise integration is still under development as of today.

6.14. ~byteたちが成す配列は `Uint8Array^c で出力すること

~APIが~byte配列を返す場合、 それを `ArrayBuffer$c ではなく `Uint8Array$c にすること。 ◎ If an API returns a byte array, make it a Uint8Array, not an ArrayBuffer.

`ArrayBuffer^c からは直に読取れないので、 開発者は，~dataを読取るために `Uint8Array^c などの~viewを作成する必要がある。 `Uint8Array^c を供すれば，そのような追加的な労は避けられる。 ◎ ArrayBuffers cannot be read from directly; the developer would have to create a view such as a Uint8Array to read data. Providing a Uint8Array avoids that additional effort.

~buffer内の~byte列には，他の いずれかの`有型~配列~型$【！ `TypedArray^jT 型】として自然な解釈【！intepretation】がある場合、 代わりに，それを供すること。 例えば，~byte列が `float$c【！`Float32^c】 値たちを表現する場合、 `Float32Array$c を利用すること。 ◎ If the bytes in the buffer have a natural intepretation as one of the other TypedArray types, provide that instead. For example, if the bytes represent Float32 values, use a Float32Array.

6.15. 目的が副作用にある関数からは `undefined^c を返すこと

ある関数の目的が，値を算出することではなく副作用にあるときは、 当の関数は， `undefined$c を返すよう指定するべきである。 ◎ When the purpose of a function is to cause side effects and not to compute a value, the function should be specified to return undefined.

各~siteが［ そのような返り値に依存するようになる ］ことは，ほぼ見込まれないので、 将来に［ ある返り値~用の利用事例が発見された ］とき［ 当の関数が有意義な値を返すよう変更を為す ］ことは，より容易になる。 ◎ Sites are unlikely to come to depend on such a return value, which makes it easier to change the function to return a meaningful value in the future should a use case for one be discovered.

次も見よ ⇒＃ `~commandと~queryの分離（ Wikipedia ）＠https://en.wikipedia.org/wiki/Command–query_separation$ ◎ See also: • Command–query separation on Wikipedia