テストユーティリティ

現行標準 — 最終更新

参加方法:
GitHub whatwg/testutils新しいissueオープン中のissue
Matrixでチャット
コミット:
GitHub whatwg/testutils/commits
このコミット時点のスナップショット
@testutils
テスト:
web-platform-tests testutils/進行中の作業
翻訳 (参考):
简体中文
日本語
한국어

概要

本書は、ブラウザーで追加のテスト機能を提供するAPIを定義します。

1. はじめに

ブラウザーのテストには、プラットフォーム不変性を損なったり、ユーザーを危険にさらす可能性があるため、ウェブ著者には公開すべきでない特殊なAPIを利用する必要があることが多いです。これにより、各Webプラットフォーム実装が独自のテストAPI定義アプローチを持つため、クロスブラウザテストの作成が難しくなります。WebDriver標準は、Webアプリケーションの自動テストに焦点を当て、一部のこれらAPIを提供しています。しかし、ブラウザー実装自体のテストでは、WebDriverフレームワークには適合しないが、テストにおいて重要な追加APIが存在します。

本仕様は、テストで使用するための追加のインブラウザーAPIを定義しますが、これらはエンドユーザー向けに有効化すべきものではありません。これらAPIの主な利用者はweb-platform-testsテストスイートです。

2. インフラストラクチャー

本仕様はInfra標準に依存します。[INFRA]

本仕様はWeb IDL標準の用語を使用します。[WEBIDL]

3. 利用可能性

本仕様で定義されるインターフェースは、ユーザーエージェントのデフォルト出荷構成では有効にしてはなりません。これらは、特別なビルドフラグや非デフォルトの設定が有効なテスト構成でのみ有効にする必要があります。

4. TestUtils名前空間

[Exposed=(Window,Worker)]
namespace TestUtils {
  [NewObject] Promise<undefined> gc();
};

gc() メソッドは次の手順を実行しなければなりません:

  1. pを新しいpromiseとして作成する。

  2. 以下を並列で実行する:

    2.1 最低でもエントリRealmをカバーするガベージコレクションを行うための実装依存の手順を実行する。

    2.2 pを解決する。

謝辞

Test Utils標準に貢献いただいた以下の方々に感謝します:

Kagami Sascha Rosylight

あなたは素晴らしいです!

この標準はJames GrahamMozillajames@hoppipolla.co.uk)によって執筆されました。

知的財産権

Copyright © WHATWG (Apple, Google, Mozilla, Microsoft)。この作業はクリエイティブ・コモンズ 表示 4.0 国際 ライセンスの下で提供されます。その一部がソースコードに組み込まれている場合、ソースコード部分は代わりにBSD 3-Clause Licenseの下でライセンスされます。

これは現行標準です。 特許審査バージョンに関心のある方は、 現行標準審査ドラフトを参照してください。

索引

本仕様で定義されている用語

他仕様で定義されている用語

参考文献

規範的参考文献

[HTML]
Anne van Kesteren ほか. HTML Standard. 現行標準. URL: https://html.spec.whatwg.org/multipage/
[INFRA]
Anne van Kesteren; Domenic Denicola. Infra Standard. 現行標準. URL: https://infra.spec.whatwg.org/
[WEBDRIVER]
Simon Stewart; David Burns. WebDriver. URL: https://w3c.github.io/webdriver/
[WEBIDL]
Edgar Chen; Timothy Gu. Web IDL Standard. 現行標準. URL: https://webidl.spec.whatwg.org/

IDL索引

[Exposed=(Window,Worker)]
namespace TestUtils {
  [NewObject] Promise<undefined> gc();
};