インストール

モジュールをインストールします

  1. npm install @wordpress/e2e-test-utils-playwright --save-dev

注意: このパッケージは、長期サポートステータスのあるNode.jsバージョンを必要とします(アクティブLTSまたはメンテナンスLTSリリースを確認)。古いバージョンとは互換性がありません。

API

テスト

拡張されたPlaywrightのtestモジュールで、admineditorpageUtils、およびrequestUtilsフィクスチャを使用します。

期待

Playwright/Jestのexpect関数。

管理者

WordPress管理者のユーザーインターフェースのエンドツーエンドテストユーティリティ。

  1. const admin = new Admin( { page, pageUtils } );
  2. await admin.visitAdminPage( 'options-general.php' );

エディター

WordPressブロックエディターのエンドツーエンドテストユーティリティ。

これらのユーティリティを使用するには、各テストファイル内でインスタンス化します:

  1. test.use( {
  2. editor: async ( { page }, use ) => {
  3. await use( new Editor( { page } ) );
  4. },
  5. } );

テストまたはテストユーティリティ内で、canvasプロパティを使用してiframeキャンバス内の要素を選択します:

  1. await editor.canvas.locator( 'role=document[name="Paragraph block"i]' );

ページユーティリティ

Webページと対話するための一般的なPlaywrightユーティリティ。

  1. const pageUtils = new PageUtils( { page } );
  2. await pageUtils.pressKeys( 'primary+a' );

リクエストユーティリティ

WordPress REST APIと対話するためのPlaywrightユーティリティ。

リクエストユーティリティのインスタンスを作成します。

  1. const requestUtils = await RequestUtils.setup( {
  2. user: {
  3. username: 'admin',
  4. password: 'password',
  5. },
  6. } );

このパッケージへの貢献

これはGutenbergプロジェクトの一部である個別のパッケージです。このプロジェクトはモノレポとして整理されています。特定の目的を持つ複数の自己完結型ソフトウェアパッケージで構成されています。このモノレポ内のパッケージはnpmに公開され、WordPressや他のソフトウェアプロジェクトで使用されています。

このパッケージやGutenberg全体への貢献について詳しく知りたい場合は、プロジェクトの主要な貢献者ガイドをお読みください。