アクション

概要

各ステップには type フィールドを持つ action オブジェクトがあります。使用可能なフィールドはアクション型によって異なります。

共通アクションフィールド

フィールド	型	必須	説明
`type`	ActionType	Yes	以下の12種類のアクション型
`selector`	Selector	型による	対象要素（click, input, select, hover で必須）
`value`	string	型による	テキスト値 — `{{variable}}` テンプレート構文対応

アクション型

`click`

DOM 要素をクリックします。

action:
  type: click
  selector:
    tagName: button
    innerText: "Submit"

フィールド	必須	説明
`selector`	Yes	クリックする要素

`input`

フォームフィールドにテキストを入力します。入力前にフィールドはクリアされます。

action:
  type: input
  value: "{{email}}"
  selector:
    tagName: input
    inputType: email

フィールド	必須	説明
`selector`	Yes	入力要素
`value`	Yes	入力テキスト（`{{variable}}` テンプレート対応）

`select`

<select> ドロップダウンからオプションを選択します。

action:
  type: select
  value: "us-west-2"
  optionText: "US West (Oregon)"
  selector:
    tagName: select
    name: "region"

フィールド	必須	説明
`selector`	Yes	select 要素
`value`	No	オプションの `value` 属性
`optionText`	No	表示テキスト（`value` 未設定時に使用）

`navigate`

ブラウザを URL に遷移させます。

action:
  type: navigate
  url: "https://app.example.com/dashboard"

フィールド	必須	説明
`url`	Yes	遷移先 URL

`scroll`

ページをスクロールします。追加フィールドは不要です。

action:
  type: scroll

`wait`

指定の条件または一定時間待機します。非同期ロードのページで有用です。

action:
  type: wait

`hover`

要素にホバーしてメニューやツールチップを表示します。

action:
  type: hover
  selector:
    tagName: div
    ariaLabel: "User menu"

フィールド	必須	説明
`selector`	Yes	ホバーする要素

`extract`

ページコンテキストで JavaScript を実行し、結果をキャプチャします。

action:
  type: extract
  script: "document.querySelector('.total').textContent"
captures:
  - name: totalAmount
    strategy: expression
    expression: "{{__extracted}}"

フィールド	必須	説明
`script`	Yes	ページで評価する JavaScript

抽出された値は {{__extracted}} としてキャプチャで使用できます。

`download`

クリックやナビゲーションでトリガーされるファイルをダウンロードします。

action:
  type: download
  downloadPath: "./downloads/report.csv"
  selector:
    tagName: a
    innerText: "Download CSV"

フィールド	必須	説明
`selector`	No	ダウンロードをトリガーする要素
`downloadPath`	No	ファイルの保存先パス

`export`

メモリコレクションを CSV または JSON ファイルにエクスポートします。

action:
  type: export
  exportCollection: "products"
  exportFormat: csv
  exportPath: "./output/products.csv"

フィールド	必須	説明
`exportCollection`	Yes	メモリコレクション名
`exportFormat`	Yes	`csv` または `json`
`exportPath`	Yes	出力ファイルパス

`memory`

メモリ操作（append または aggregate）を実行します。このアクション型はショートハンドです。任意のステップで memoryOperations を使用することもできます。

action:
  type: memory

詳細はメモリ操作を参照してください。

`key`

キーボードキーまたはキーの組み合わせを押します。

action:
  type: key
  keys: "Enter"

フィールド	必須	説明
`keys`	Yes	Playwright 形式のキー名（例: `Enter`, `Tab`, `ArrowDown`, `Control+a`）

サマリーテーブル

アクション	セレクタ	値	その他のフィールド
`click`	必須	—	—
`input`	必須	必須	—
`select`	必須	任意	`optionText`
`navigate`	—	—	`url`
`scroll`	—	—	—
`wait`	—	—	—
`hover`	必須	—	—
`extract`	—	—	`script`
`download`	任意	—	`downloadPath`
`export`	—	—	`exportCollection`, `exportFormat`, `exportPath`
`memory`	—	—	—
`key`	—	—	`keys`

はじめに

ワークフローガイド

ユースケース

サポート

Web コンソール

CLI リファレンス

SDK

手順書 YAML

コンセプト

概要

共通アクションフィールド

アクション型

`click`

`input`

`select`

`navigate`

`scroll`

`wait`

`hover`

`extract`

`download`

`export`

`memory`

`key`

サマリーテーブル

​概要

​共通アクションフィールド

​アクション型

​click

​input

​select

​navigate

​scroll

​wait

​hover

​extract

​download

​export

​memory

​key

​サマリーテーブル

概要

共通アクションフィールド

アクション型

`click`

`input`

`select`

`navigate`

`scroll`

`wait`

`hover`

`extract`

`download`

`export`

`memory`

`key`

サマリーテーブル