設定ガイド: 各設定の役割
Studioで設定を開くと、各項目の名前のすぐ下に説明が表示されます。このページでは同じ説明を一か所にまとめているので、事前に読んだり、検索したり、AIアシスタントに解説を頼んだりできます。
最終更新日:
設定の仕組み
- 変更したら保存します。必要な項目を編集し、変更を保存を押してください。設定の横にある点は、変更がまだ保存されていないことを示します。
- ほとんどの方は、わずかな変更で済みます。すべての設定には適切な初期値が用意されています。迷った場合は、そのままにしてください。
- 機密情報はお使いのコンピューター内に留まります。パスワード、トークン、キーは作業領域の
.envファイルに保存され、画面上では点で表示されます。当社には何も送信されません。 - 灰色の名前は、ファイル内での設定名です。
.env内の該当する行を示しており、パイプラインやスクリプトから設定する際に使えます。
セキュリティ & 認証
APIテスト用のログイン.
| 設定 | 主な機能 | 既定 |
|---|---|---|
APIトークンまたはパスワードAPI_AUTH_TOKEN | APIが認証時に確認する秘密情報です。API提供元のアカウントページで取得してください。Basicの場合はuser:passwordと入力します。空欄の場合は認証しません。レポートには先頭の4文字のみ表示されます。 | 空欄。このコンピューターにのみ保存されます。 |
APIの認証方法API_AUTH_TYPE | APIが呼び出し元を確認する方法です: Bearerはトークン、Basicはユーザー名とパスワード、ApiKeyはヘッダー内のキーを送信します。既定値はBearerです。 | Bearer |
APIキーのヘッダー名API_AUTH_HEADER | ApiKey専用: api-keyなど、キーを渡すヘッダーの名前。空欄の場合はX-Api-Keyを使用します。 | Empty |
Smart Monkey
探索中にAPIの安全性を追加確認.
| 設定 | 主な機能 | 既定 |
|---|---|---|
APIの受動的な安全性検査NEXUS_API_AUDIT | 探索中に, アプリがすでに受信しているAPI応答を読み取り, データ漏えいなどの弱点を検出しますが, 追加の送信は行いません. 既定では無効です; テストを許可されているアプリでのみ使用してください. | false |
ログイン回避の確認NEXUS_API_ACTIVE | アプリがログイントークン付きで送信したデータ要求を, トークンなしで再送信し, サーバーが応答するか確認します. 読み取り専用ですが, 追加の要求を送信します; 既定では無効です. | false |
対象 & API
APIアドレス、速度制限、保存する証跡.
| 設定 | 主な機能 | 既定 |
|---|---|---|
APIのベースアドレスAPI_BASE_URL | パスのみ (/usersなど) を指定したAPIテストの起点となるアドレスです。例: https://api.example.com。空欄のままにしてください: 値を設定すると、記録済みのすべてのAPIテストもそのアドレスに転送されます。 | Empty |
GraphQLのアドレスAPI_GRAPHQL_URL | GraphQLサービスのアドレスです (GraphQLは必要なデータだけを指定して取得できるAPIです)。空欄の場合、組み込みのGraphQLサンプルはご自身のサービスではなく、公開デモサービスに問い合わせます。 | Empty |
許容する最長応答時間NEXUS_API_LATENCY_BUDGET | APIの応答に許容する最長時間。単位はミリ秒 (1000 = 1秒); これを超える応答は低速と判定されます。既定値は2000 (2秒)。 | 2000 |
リクエストごとの時間測定回数NEXUS_API_SAMPLES | 速度を正確に測定するために各APIリクエストを送信する回数です (1から200); 最初の応答のみを検証します。既定値は20です; 繰り返し送信がサーバーの負担になる場合は値を小さくしてください。 | 20 |
データを変更する要求を再送信NEXUS_API_SAMPLE_WRITES | データを作成または変更するリクエスト(POST, PUT, PATCH, DELETE)も繰り返します。20回繰り返すとサーバー上に20件のレコードが作成されるため、既定では無効です。 | false |
応答が変化したら失敗とするNEXUS_API_DRIFT_STRICT | フィールドが追加された応答やデータ型が変わった応答は、常に差異として報告されます。有効にするとテストも失敗になります。無効(既定)の場合は報告のみ行います。 | false |
保持する合格したAPI実行の数NEXUS_API_EVIDENCE_KEEP | 各APIテストで、保存済みの証跡を保持する成功した実行の数です; 古いものは削除されますが、失敗した実行の証跡は削除されません。既定値は20です; 0にするとすべての実行を保持します。 | 20 |
保存する応答の最大サイズNEXUS_API_BODY_MAX_KB | 証跡ファイルに保存するリクエスト本文または応答本文の最大サイズ(KB単位)です。これを超える本文は切り詰められ、元のサイズとフィンガープリントとともに保存されます。既定値は256 KBです。 | 256 |
応答が遅ければ失敗とするNEXUS_API_PERF_STRICT | 有効にすると, 応答が上記の許容時間を超えた場合にAPIテストを失敗とします. 無効 (既定): 応答が遅くても警告が追加されるだけです. | false |
APIのセキュリティヘッダーを確認NEXUS_API_SECURITY_HEADERS | APIの応答に標準の保護ヘッダー (例: Content-Security-Policy) が含まれているかを確認します。不足している場合は助言として記録されますが, それだけでテストが失敗することはありません. 既定で有効です. | true |
テスト対象のアプリ
実行前にアプリを自動起動.
| 設定 | 主な機能 | 既定 |
|---|---|---|
アプリを起動するコマンドNEXUS_APP_START | 各実行の前にアプリを起動し、終了後に停止します。例: npm run dev; 空欄 = 自分で起動します。コマンドは1つのみです: &&などで連結する場合はpackage.jsonのスクリプトに記述してください。 | Empty |
アプリのフォルダーNEXUS_APP_CWD | アプリの起動元で, package.jsonがあるフォルダーの絶対パスです。空欄の場合はこのワークスペースのフォルダーを使用します. リモートマシンの場合は, そのマシン上のフォルダーを指定します. | Empty |
準備完了を示すアドレスNEXUS_APP_READY_URL | アプリの起動を確認するために0.5秒ごとに確認するウェブアドレスです。サーバーエラー以外の応答があれば起動済みと判定します。空欄の場合はメインのテストアドレス (BASE_URL) を使用します。 | Empty |
起動待機時間の上限NEXUS_APP_TIMEOUT_MS | アプリの準備が整うまで待つ時間をミリ秒で指定します (1000 = 1秒); この時間を超えると、実行は開始されません。既定値は120000 (2分) です。 | 120000 |
実行中のアプリを再利用NEXUS_APP_REUSE | 有効: アプリが準備完了確認用のアドレスですでに応答している場合、そのアプリを使用し、実行後も停止しません; 無効: 誤って別の対象をテストしないよう、エラーで実行を停止します。既定では有効です。 | true |
実行 & タイムアウト
実行するテスト数と待ち時間.
| 設定 | 主な機能 | 既定 |
|---|---|---|
テストごとのブラウザー数NEXUS_PARALLEL_BROWSERS | 1つのテストを同時に実行するブラウザーの数で、1から3まで指定できます; 既定値の1が最も安全で、2には約8 GB、3には約16 GBのメモリが必要です。ブラウザーを1つに固定した実行では常に1を使用します。 | 1 |
同時実行テスト数NEXUS_PARALLEL_TCS | 全体実行で並行して実行するテストの数で、1から32まで指定できます; 既定値は1 (順次実行) です。テストを1つ増やすごとにブラウザーあたり約0.5 GBのメモリが必要なため、高性能なPCでのみ値を大きくしてください。 | 1 |
失敗したテストを再試行NEXUS_RETRY_ENABLED | 失敗したテストは、報告前にもう一度実行されるため、一時的な不具合による失敗を除外できます。すべての失敗をすぐに確認するには無効にしてください。既定では有効です。 | true |
テストごとの制限時間NEXUS_TC_TIMEOUT | 1回のテストを強制停止するまでの最長実行時間。単位は秒。既定値は360 (6分); 証跡を保存できるよう、テスト自体は1分前に停止します。 | 360 |
確認時の待機時間NEXUS_EXPECT_TIMEOUT | 確認条件 (例: "このテキストが表示される") が満たされるまで待つ時間をミリ秒で指定します (1000 = 1秒); 値を大きくすると、不具合を見逃すことなく遅いページに対応できます。既定値は10000 (10秒) です。 | 10000 |
クリックや文字入力ごとの待機時間NEXUS_ACTION_TIMEOUT | クリックや文字入力などの操作で、対象の準備が整うまで待つ時間をミリ秒で指定します (1000 = 1秒)。遅いページでは値を大きくしてください; 既定値は30000 (30秒) です。 | 30000 |
ページが開くまでの時間の上限NEXUS_NAV_TIMEOUT | ページを開く操作が失敗と判定されるまでの待ち時間をミリ秒で指定します (1000 = 1秒)。既定値は60000 (1分) です; 非常に遅いサイトでは値を大きくしてください。 | 60000 |
ページを開いた後の待機時間NEXUS_LOAD_WAIT_MS | ページを開いた後、読み込み完了まで最大でこのミリ秒数(1000 = 1秒)だけ待機し、クリックが早すぎるのを防ぎます。この待機でテストが失敗することはありません。0で待機を省略し、既定値は8000です。 | 8000 |
セキュリティヘッダーが不足していたら失敗とするNEXUS_SECURITY_STRICT | 有効にすると, アプリのページに保護用のヘッダー (Content-Security-Policyなど) がない場合にテストを失敗とします. 無効 (既定) の場合は報告書に記載するだけです; 古いアプリでは, すべてのテストが失敗する可能性があります. | false |
Firefoxの場所NEXUS_FIREFOX_BINARY | firefox.exeの絶対パスで, Seleniumテストでのみ使用されます。空欄 = 通常の場所を検索します. パスが間違っている場合はFirefoxがないとみなされるため, 該当するSeleniumテストはスキップされます. | Empty |
意図的に失敗させるテストNEXUS_FIXTURE_TCS | 意図的に失敗するように作成されたテストのIDを、カンマで区切って指定します。明示的に指定しない限り、これらのテストはリスクランキングに含まれません。既定では空です。 | Empty |
セレクター & 自己修復
壊れやすいセレクターの検出と修復.
| 設定 | 主な機能 | 既定 |
|---|---|---|
不安定なステップの警告NEXUS_SMART_SELECTORS | テストの記録または読み込み時に, 提案を選ぶと, 不安定な方法で要素を探す各手順の上にコメントが追加されます; 無効を選ぶと追加されません. 作成済みのテストは変更されません; 既定は提案です. | suggest |
自動修正の提案NEXUS_SELF_HEAL | 失敗後、バックグラウンドのブラウザーで修正案を準備します (RAMが不足している場合や実行中の場合はスキップされます)。提案では修正案を表示し、検証ではさらに3つのブラウザーでテストします。オフでは何もしません。 | suggest |
MLOps & 予測
信頼性の低いテストを予測.
| 設定 | 主な機能 | 既定 |
|---|---|---|
不安定なテストの予測を更新NEXUS_AUTO_PREDICT | 実行のたびに、不安定なテスト(成功したり失敗したりするテスト)の予測を更新し、リスク順位を最新に保ちます。既定では有効です。 | true |
アクセシビリティ
axe-coreによるWCAG監査.
| 設定 | 主な機能 | 既定 |
|---|---|---|
アクセシビリティを確認NEXUS_A11Y_ENABLED | 低いコントラストやラベルの欠落など, 障害のある方の利用を妨げる問題がページにないか検査します. 既定では無効です; @axe-core/playwrightの追加機能が必要で, ない場合は検査をスキップします. | false |
アクセシビリティの規則集NEXUS_A11Y_STANDARD | 検査に使うアクセシビリティ基準 (WCAG) を選択します: バージョン2.0, 2.1または2.2のレベルA (基本) またはAA (標準). 既定の2.1 AAは, 欧州で一般的な法的基準です. | wcag21aa |
検出対象とする問題の最低重要度NEXUS_A11Y_FAIL_LEVEL | 違反とみなす問題の重大度 (軽微, 中程度, 重大, 致命的) です。既定値は重大です; '違反時にテストを失敗にする' が有効な場合にのみ適用されます。 | serious |
違反があればテストを失敗とするNEXUS_A11Y_STRICT | 有効にすると, 最低重大度以上の問題が見つかったテストを失敗とします (A11Y_VIOLATION). 既定では無効です: 問題は報告書に記載されるだけです. | false |
Performance
Core Web Vitalsの許容値.
| 設定 | 主な機能 | 既定 |
|---|---|---|
ページ速度を測定NEXUS_PERF_ENABLED | 各ページの読み込み速度と反応速度 (Core Web Vitals) を測定し、以下の上限と比較します。既定では有効です; データを追加するだけで、「遅いページを不合格にする」が有効でない限り、テストを不合格にすることはありません。 | true |
主要コンテンツの読み込み時間の上限NEXUS_PERF_LCP | ページの主要コンテンツが表示されるまでの最長時間。単位はミリ秒 (1000 = 1秒)。既定値はGoogleの「良好」の基準である2500 (2.5秒); 遅いサイトでは値を大きくしてください。 | 2500 |
最初のコンテンツ表示時間の上限NEXUS_PERF_FCP | ページに最初の文字や画像が表示されるまでの最長時間。単位はミリ秒 (1000 = 1秒)。既定値はGoogleの「良好」の基準である1800 (1.8秒); 遅いサイトでは値を大きくしてください。 | 1800 |
ページの表示ずれの上限NEXUS_PERF_CLS | 読み込み中のページの表示位置のずれをどこまで許容するかを示す指標で、0は完全に安定していることを意味します。既定値はGoogleの「良好」の基準である0.1です; 小さい値ほど厳しくなります。 | 0.1 |
ページ要素数の上限NEXUS_PERF_DOM | 低速端末には負荷が高いと判定されるまでに、ページに含められる要素 (ボタン、テキスト領域、画像) の最大数。既定値は1500。 | 1500 |
ページのメモリ使用量の上限NEXUS_PERF_HEAP | ページに問題があると判定されるまでに、ページのスクリプトが使用できる最大メモリ量。単位はMB。既定値は50 MB; ChromeやEdgeなど、Chromiumベースのブラウザーでのみ測定されます。 | 50 |
クリック応答時間の上限NEXUS_PERF_INP | クリックやタップ後にページが反応するまでの最長時間。単位はミリ秒 (1000 = 1秒)。既定値はGoogleの「良好」の基準である200; 遅いサイトでは値を大きくしてください。 | 200 |
ページの応答停止時間の上限NEXUS_PERF_TBT | 読み込み中にページが固まり、クリックに反応しない状態を許容する最長時間。単位はミリ秒 (1000 = 1秒)。既定値はLighthouse (Googleの監査ツール) の「良好」の基準である200。 | 200 |
サーバー応答の上限NEXUS_PERF_TTFB | サーバーがページの送信を開始するまでの最長時間。単位はミリ秒 (1000 = 1秒)。既定値は800; 結果が遅い場合、通常はページの設計ではなくサーバーに原因があります。 | 800 |
速度低下の許容範囲NEXUS_PERF_TOLERANCE | Evidence Lockerが性能低下と判定する、ページ自身の過去の結果に対する遅延の許容倍率です。既定値の1.25は25%遅いことを意味します; 1以下の値は1.25として扱われます。 | 1.25 |
ページが遅ければ失敗とするNEXUS_PERF_STRICT | 有効にすると, ページが上記の速度制限のいずれかを超えた場合にテストを失敗とします (PERFORMANCE_DEGRADED). 既定では無効です: 遅いページは報告書に記録されるだけです. | false |
画像の読み込みを確認NEXUS_LAZY_ENABLED | 主要な画像の読み込みが遅延しないなど, ページの速度を維持できる方法で画像が読み込まれるかを確認します. 既定で有効で, 速度測定を有効にする必要があります. テストを失敗させずに0~100の評価点を付けます. | true |
初回読み込み時の画像の上限NEXUS_LAZY_MAX_INITIAL_IMG_KB | 検査で問題と判定されるまでに、ページを最初に開いたときにダウンロードできる画像データの最大量。単位はKB (1000 KBは約1 MB)。既定値は1000 KB。 | 1000 |
画像に問題があれば失敗とするNEXUS_LAZY_STRICT | 有効にすると, メイン画像の読み込みが意図的に遅延されている場合や, 初回読み込み時の画像が上記の上限を超えた場合にテストを失敗とします (PERFORMANCE_DEGRADED). 既定では無効です: 報告されるだけです. | false |
負荷テスト
通信負荷試験の制限.
| 設定 | 主な機能 | 既定 |
|---|---|---|
応答時間の上限NEXUS_LOAD_P95 | 負荷試験で、95%のリクエストが完了しなければならない時間をミリ秒で指定します (1000 = 1秒)。空欄は制限なしを意味し、結果には '未評価' と表示されます; シナリオ独自の制限が優先されます。 | Empty |
許容エラー率NEXUS_LOAD_ERROR_RATE | 負荷テストの実行で許容するリクエストの最大失敗率。0から100の百分率で指定します (5は100件中5件まで失敗を許容)。空欄の場合は上限なし; シナリオ独自の上限がある場合はそちらが優先されます。 | Empty |
許容値を満たさなければ実行を失敗とするNEXUS_LOAD_STRICT | 有効にすると, 応答時間またはエラーの上限を超えた負荷テストは失敗となり, 自動ビルドが停止します. 既定では無効です: 結果が報告されるだけです. | false |
負荷生成処理の数NEXUS_LOAD_POOL | 負荷試験で通信を生成するバックグラウンド処理の数です。空欄の場合はプロセッサーのコアごとに1つ使用しますが、仮想ユーザー数は超えません; Windowsでは1つあたり約80 MBを消費します。 | Empty |
ハードウェア & 実行間隔
メモリの少ないコンピューターではテスト速度を下げる.
| 設定 | 主な機能 | 既定 |
|---|---|---|
空きRAMに応じてテストの実行ペースを調整NEXUS_HW_MONITOR_ENABLED | 有効にすると, RAMの空き容量が少ないときにテスト間の待機時間を延ばし, 同時実行数を減らします. 既定では無効 (待機時間は固定) です; 小規模なコンピューターや負荷の高いコンピューターでは有効にしてください. | false |
テスト間の待機時間NEXUS_HW_FIXED_PAUSE_MS | RAMに応じた実行調整が無効のとき, 複数テストの実行時に設けるテスト間の待機時間をミリ秒で指定します (1000 = 1秒). 既定値は2000 (2秒) です; 単独のテスト実行では待機しません. | 2000 |
小型PCのRAM上限NEXUS_HW_CRITICAL_GB | 総RAM容量がこの値 (GB単位) 未満のコンピューターを極小規模とみなし, テスト間の待機時間を最長にします. 既定値は4です。RAM容量に応じた実行間隔の調整が有効な場合のみ使用されます. | 4 |
小型PCのRAM上限NEXUS_HW_LIMITED_GB | 総RAM容量がこの値 (GB単位) 未満のコンピューターを小規模とみなします. 既定値は8です。RAM容量に応じた実行間隔の調整が有効な場合のみ使用され, 極小規模の上限より大きい値にする必要があります. | 8 |
標準PCのRAM上限NEXUS_HW_NORMAL_GB | 総RAM容量がこの値 (GB単位) 未満のコンピューターを標準とみなします。この値を超える場合は高性能とみなし, 待機時間が最短になります. 既定値は16です。RAM容量に応じた実行間隔の調整が有効な場合のみ使用されます. | 16 |
RAMに十分な空きがあるときの待機時間NEXUS_PAUSE_LOW_MS | RAMの大部分が空いているときのテスト間の待機時間をミリ秒で指定します (1000 = 1秒). 0 (既定) は待機なしではなく, PCの規模に応じて内蔵の1~3秒を使用します; RAMに応じた実行調整が有効な場合にのみ使用されます. | 0 |
RAM使用量が中程度のときの待機時間NEXUS_PAUSE_MEDIUM_MS | RAM使用量が中程度のときのテスト間の待機時間をミリ秒で指定します (1000 = 1秒). 0 (既定) は待機なしではなく, PCの規模に応じて内蔵の2~8秒を使用します; RAMに応じた実行調整が有効な場合にのみ使用されます. | 0 |
RAMの空きが少ないときの待機時間NEXUS_PAUSE_HIGH_MS | RAMの空き容量が少なくなったときのテスト間の待機時間をミリ秒で指定します (1000 = 1秒). 0 (既定) は待機なしではなく, PCの規模に応じて内蔵の4~15秒を使用します; RAMに応じた実行調整が有効な場合にのみ使用されます. | 0 |
RAMが満杯のときの待機時間NEXUS_PAUSE_CRITICAL_MS | RAMがほぼ満杯のときのテスト間の待機時間をミリ秒で指定します (1000 = 1秒). 0 (既定) は待機なしではなく, PCの規模に応じて内蔵の8~25秒を使用します; RAMに応じた実行調整が有効な場合にのみ使用されます. | 0 |
Devices & Mobile
テスト対象および模擬対象のスマートフォン.
| 設定 | 主な機能 | 既定 |
|---|---|---|
スマートフォン接続ポートNEXUS_DEVICE_CDP_PORT | 接続したAndroidスマートフォンのChromeと通信するためにコンピューターが使用するネットワークポート番号です。既定値の9333を別のプログラムが使用している場合のみ変更してください。 | 9333 |
スマートフォンのブラウザーアプリIDNEXUS_DEVICE_CHROME_PKG | 接続したAndroidスマートフォンでテストするブラウザーのアプリIDです。別のブラウザーを使用する場合のみ変更してください。既定値は通常のChrome (com.android.chrome) です。 | com.android.chrome |
PCからスマートフォンを操作NEXUS_MIRROR_CONTROL | パソコンに映したスマートフォンの画面から、端末へのタップや文字入力を行えます。無効にするとクリックに反応しない閲覧専用のウィンドウになります; 既定では有効です。 | true |
模倣する高性能スマートフォンNEXUS_TIER_HIGH_DEVICE | 高性能環境での実行時に、画面サイズ、ブラウザーの識別情報、タッチ操作を再現するスマートフォンの機種です。実機のiPhoneではなく、Safariのエンジン上でのシミュレーションです。既定はiPhone 13です。 | iPhone 13 |
再現する中性能のスマートフォンNEXUS_TIER_MID_DEVICE | 標準のモバイル実行で画面サイズ、ブラウザー識別情報、タッチ操作を再現するスマートフォンの機種です。Androidスマートフォンを選択してください。既定値はPixel 5です。 | Pixel 5 |
再現する低性能のスマートフォンNEXUS_TIER_LOW_DEVICE | 低性能端末向けの実行で再現するスマートフォンの機種です。この実行ではプロセッサーの速度も低下させます。Androidスマートフォンを選択してください。空欄の場合は組み込みの低価格端末 (Nokia 1) を使用します。 | Empty |
低性能端末の減速倍率NEXUS_CPU_THROTTLE_RATE | 低性能スマートフォンのテストで、性能の低い端末を再現するためにプロセッサーの処理時間を何倍にするかを指定します。2から20を指定してください (大きいほど遅くなります); 既定値は4で、Chrome系ブラウザーでのみ有効です。 | 4 |
低速回線NEXUS_NETWORK_PROFILE | すべてのテストを低速回線で実行し、携帯電話の電波が弱い状況でのサイトの動作を確認します: off (既定), fast-4g, slow-4g, slow-3g または offline。Chrome系ブラウザーとAndroid実機のみ対応しています。 | 無効 |
証跡 & 保持
保存する証拠と保存期間.
| 設定 | 主な機能 | 既定 |
|---|---|---|
失敗時の動画を記録NEXUS_VIDEO_ENABLED | 各テストの動画を記録し, 失敗したテストの動画を保存できるようにします. 無効にするとコンピューターの処理負荷とディスク使用量を抑えられますが, 失敗時の動画は残りません; 既定では有効です. | true |
動画を保持する失敗件数NEXUS_VIDEO_VERDICTS | 動画を保存する結果を選択します: 失敗, 再試行後の失敗, カオス条件下での失敗, 時間切れ, またはブロック. 空欄またはnoneの場合は動画を保存しません; 既定では最初の3つです. | BREACHED,BREACHED_FLAKY,CHAOS_BREACHED |
操作ごとの再現記録を保存NEXUS_TRACE_ENABLED | 各テストのすべての操作とページの状態を記録し, 失敗時の不具合報告に再現記録を保存します. 小型のコンピューターでは無効にすると処理負荷を抑えられます; 既定では有効です. | true |
テストごとに保持する不具合報告数NEXUS_BUGREPORT_RETAIN | テストとブラウザーの組み合わせごとに保持する失敗レポートの数です。古いものは完全に削除されるため、長期間の記録が必要な場合は値を大きくしてください; 既定値は20です。 | 20 |
保持する合格時の画面画像の数NEXUS_PASSED_RETAIN | テストとブラウザーの組み合わせごとに保持する、成功した実行のスクリーンショットの数です。古いものは完全に削除されます; 既定値は5です。 | 5 |
保持するSmart Monkeyセッション数NEXUS_MONKEY_RETAIN | 保持するSmart Monkeyセッション (アプリ上で無作為にクリックや文字入力を行うもの) の数です。古いセッションは完全に削除されます; 既定値は10です。 | 10 |
保持する実行記録数NEXUS_RUN_CONTEXT_RETAIN | テスト対象の記録とアプリのログを保持する実行の数です。古い記録は完全に削除されます; 既定値は100です。 | 100 |
再試行で成功した実行の証跡を保持するNEXUS_RECOVERED_RETAIN | 再試行後, または変更されたページ要素をアプリが自動修復した後にのみ成功したテストのスクリーンショットと注記を保存します. 無効にするとこれらの記録を保存しません; 既定では有効です. | true |
証跡の合計上限 (GB)NEXUS_EVIDENCE_MAX_GB | すべての証跡に使用できるディスク容量の上限です。実行のたびに、成功した実行を優先して古い証跡から完全に削除しますが、各テストの最新の実行は保持します。既定値は20 GBです。 | 20 |
確保するディスク空き容量 (GB)NEXUS_MIN_FREE_GB | ディスクに確保しておく空き容量です。これを下回ると、合計上限に達していなくても古い証跡から完全に削除されます (0で無効化)。既定値は10 GBです。 | 10 |
実行履歴の保存件数NEXUS_HISTORY_RETAIN | テストとブラウザーの組み合わせごとに記録する過去の結果の数で、傾向分析やグラフに使われます。1日に何度も実行するテストでは値を大きくしてください; 既定値は50です。 | 50 |
プライバシー & ステルス
広告のブロックとサイトからの自動操作の隠蔽.
| 設定 | 主な機能 | 既定 |
|---|---|---|
テストが自動化されていることを隠すNEXUS_STEALTH_ENABLED | テスト用ブラウザーを一般ユーザーのブラウザーのように見せ、ボットをブロックするサイトにもアクセスできるようにします。セキュリティスキャンや実機のスマートフォンでは使用されません。既定ではオフです。 | false |
テスト中に広告をブロックNEXUS_BLOCK_ADS | 記録中とテスト実行中は広告ネットワークの読み込みを防ぎ, 広告のポップアップがボタンを覆わないようにします. ご自身のアプリがブロックされることはありません; 既定では有効で, セキュリティ検査には適用されません. | true |
Reports
経営層向けPDF/HTML報告書.
| 設定 | 主な機能 | 既定 |
|---|---|---|
報告書に表示する会社名ORG_ID | PDFレポートに印字する組織名です。Studioを初めて開いたときにプロフィールから入力されます。空欄の場合はコンピューター名を使用します。 | Empty |
レポートの言語NEXUS_PDF_LANGUAGE | 全体の実行後に作成される印刷用概要レポートの言語です。英語 (en) またはスペイン語 (es) を選択してください。既定値は英語です。 | en |
レポートの署名者名NEXUS_QA_ENGINEER_NAME | レポートの承認欄に表示する名前です。結果を承認する担当者を設定してください。既定値はQAエンジニアです。 | QA Engineer |
Notifications
テストごとにTelegram、Slack、Teamsへ通知します。
| 設定 | 主な機能 | 既定 |
|---|---|---|
失敗ごとのTelegram通知NEXUS_TELEGRAM_NOTIFY | 失敗したテストごとにTelegramメッセージを送信します. 下でTelegramも有効にして接続している場合にのみ機能します; 既定では無効のため, Telegramを有効にするだけで大量の通知が届くことはありません. | false |
失敗ごとにSlackへ通知NEXUS_SLACK_NOTIFY | 失敗, 不安定, カオス, または表示変更の各テストについてSlackメッセージを送信します. 下でSlackも有効にして接続している場合にのみ機能します; 既定では無効です. | false |
成功時にTelegramへ通知NEXUS_NOTIFY_ON_PASS | テスト成功時にもTelegramメッセージを送信します。Telegramの失敗通知も有効にする必要があります。テスト数が多いと通知が多くなるため、既定では無効です。 | false |
失敗ごとにTeamsへ通知NEXUS_TEAMS_NOTIFY | 失敗、不安定、カオス、表示の変化に該当するテストごとにMicrosoft Teamsへメッセージを送信します。以下でTeamsも有効にし、接続している場合のみ機能します。既定では無効です。 | false |
連携機能
Slack、Teams、Jira、Azure DevOps、GitHub Issues、Telegram。
| 設定 | 主な機能 | 既定 |
|---|---|---|
通知をTelegramに送信TELEGRAM_ENABLED | テストの概要と共有するファイルを外部サービスのTelegramへ送信します. 既定では無効です; 会社でこのコンピューター外へのデータ送信が禁止されている場合は無効のままにしてください. | false |
TelegramボットのアクセスコードTELEGRAM_TOKEN | ご自身のTelegramボット (無料の補助アカウント) の秘密コードです。Telegramで@BotFatherに/newbotを送信して取得してください。このコンピューターにのみ保存され、共有されることはありません。 | 空欄。このコンピューターにのみ保存されます。 |
通知先のTelegramチャットTELEGRAM_CHAT_ID | 通知先のTelegramチャットを識別する番号です。設定 → 連携の「接続」でQRコードを読み取ると、自動入力されます。 | Empty |
失敗時にJiraのチケットを作成JIRA_ENABLED | テストが失敗するとJiraのバグ課題を作成し、以降の実行で更新します。Jiraの任意のリンクを貼り付けるJira Connectを保存すると、自動で有効になります。 | false |
JiraサイトのアドレスJIRA_BASE_URL | Jiraのウェブアドレスです。例: https://yourteam.atlassian.net。接続画面にJiraの任意のリンクを貼り付けると、自動入力されます。 | Empty |
Jiraサインイン用メールアドレスJIRA_EMAIL | Jiraへのサインインに使用するメールアドレスです。Jira接続画面でアクセストークンとともに入力します。 | Empty |
JiraアクセストークンJIRA_API_TOKEN | StudioがJiraアカウントを使用するための、パスワードに似たコードです。Atlassianアカウントのセキュリティ → APIトークンで作成します。このコンピューターにのみ保存され、共有されることはありません。 | 空欄。このコンピューターにのみ保存されます。 |
不具合チケット用のJiraプロジェクトJIRA_PROJECT_KEY | プロジェクトの各チケット番号の前に付く短いコードです。例: QA-123のQA。Jira接続画面でプロジェクトを選択すると入力されます。 | QA |
テスト成功時のJiraステータスJIRA_DONE_TRANSITION | すべてのブラウザーでテストが再び成功したときにバグを移行する状態です。例: 完了。空欄の場合は完了を使用します。Jiraにその状態がない場合、Studioはコメントの追加のみを行います。 | 完了 |
記録全体をチケットに添付NEXUS_ISSUE_ATTACH_TRACE | 詳細な操作記録と未加工のログをJiraおよびAzureのチケットに添付します。Cookieや入力したパスワードが含まれる場合があり、プロジェクトの全員が閲覧できるため、既定では無効です。 | false |
流出した不具合のJira検索NEXUS_JIRA_ESCAPED_JQL | 本番環境に流出した不具合を検出するJira検索フィルターです。例: status = Done AND labels = production。空欄の場合、流出不具合の指標には"未設定"と表示されます。 | Empty |
失敗時にAzureの作業項目を作成AZURE_BOARDS_ENABLED | テストが失敗するとAzure Boardsの作業項目 (チケット) を作成し, 以降の実行で更新します. Azure DevOpsへの接続設定を保存すると自動的に有効になります. | false |
Azure DevOps組織のアドレスAZURE_DEVOPS_ORG_URL | 組織のウェブアドレスです。例: https://dev.azure.com/yourcompany。接続画面にAzure DevOpsの任意のリンクを貼り付けると、自動入力されます。 | Empty |
Azure DevOpsプロジェクト名AZURE_DEVOPS_PROJECT | 作業項目の登録先となり、パイプラインを実行する組織内のプロジェクトです。Azure DevOps接続画面でプロジェクトを選択すると入力されます。 | Empty |
Azure DevOpsアクセストークンAZURE_DEVOPS_PAT | Azureアカウント用のパスワードに似たコード(個人用アクセストークン)です。ユーザー設定 → 個人用アクセストークンで作成します。このコンピューターにのみ保存され、共有されることはありません。 | 空欄。このコンピューターにのみ保存されます。 |
失敗時のAzureチケットの種類AZURE_BOARDS_WORK_ITEM_TYPE | 失敗時に作成する作業項目の種類です。例: バグ。プロジェクトに存在する種類を指定してください。空欄の場合はバグを使用します。 | Bug |
テスト成功時のAzureの状態AZURE_BOARDS_DONE_STATE | テストが再び成功したときに作業項目を移行する状態です。例: 解決済み。空欄の場合は解決済みを使用します。プロジェクトでその状態への移行が認められない場合、Studioはコメントの追加のみを行います。 | Resolved |
CIで実行するAzureパイプラインAZURE_PIPELINE_ID | 「CIで実行」で起動するAzureパイプラインの番号です。Azure DevOpsでパイプラインを開き、アドレスバーのdefinitionId=の後にある番号をコピーしてください。 | Empty |
通知をSlackに送信SLACK_ENABLED | テストの失敗, 概要などの通知をSlackに投稿します. 既定では無効です; Slack Connectを保存すると自動で有効になり, テストメッセージを送信できます. | false |
通知先のSlackチャンネルSLACK_WEBHOOK_URL | Studioが特定のチャンネルに投稿するための非公開のSlackリンクです。Slack → アプリ → Incoming Webhooksで作成します。このコンピューターにのみ保存され、共有されることはありません。 | 空欄。このコンピューターにのみ保存されます。 |
Microsoft Teamsに通知を送信TEAMS_ENABLED | テストの失敗と要約をTeamsのチャネルに投稿します。既定では無効です: TeamsのWebhookを保存すると有効になり、テストメッセージを送信できます。 | false |
通知先のTeamsチャネルTEAMS_WEBHOOK_URL | Studioから1つのTeamsチャネルに投稿するための非公開リンク (Webhook) です。チャネルの···メニュー → ワークフロー → “Webhook要求を受信したときにチャネルに投稿する”で作成してください。 | 空欄。このコンピューターにのみ保存されます。 |
失敗時にGitHubのIssueを作成GITHUB_ISSUES_ENABLED | テストが失敗すると GitHub の Issue を作成し、再び失敗するとコメントを追加し、成功するとクローズします。GitHub Issues カードを保存すると有効になります。 | false |
GitHubアクセストークンGITHUB_ISSUES_TOKEN | Studio が1つのリポジトリに Issue を作成するための、パスワードのようなコード (トークン) です。GitHub で Issues の権限を「読み取りと書き込み」に設定して作成します。このコンピューターにのみ保存されます。 | 空欄。このコンピューターにのみ保存されます。 |
Issue作成先のGitHubリポジトリGITHUB_ISSUES_REPO | Issue の作成先リポジトリです。acme/web のように owner/repo の形式で表します。GitHub Issues カードの一覧から選択してください。 | Empty |
独自のシステムにチケットを送信TICKETS_HOOK_ENABLED | テストが失敗するたびに、所有するウェブアドレスに署名付きメッセージを送信し、独自のツールでチケットを作成できるようにします。初期設定では無効です。チケット設定に「webhook」の送信先も必要です。 | false |
チケットシステムのアドレスTICKETS_WEBHOOK_URL | 各チケットをメッセージとして受信する https のウェブアドレスです。このコンピューターにのみ保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
チケットの署名用パスワードTICKETS_WEBHOOK_SECRET | 16 文字以上のパスワードです。各メッセージの署名に使用され、システム側でメッセージが本当にここから送信されたものか確認できます。 | 空欄。このコンピューターにのみ保存されます。 |
CI/CD用のGitHubトークンGITHUB_CI_TOKEN | ghプログラムを使わずにCIのシークレットをGitHubに保存する、パスワードのようなコード(トークン)です。Secretsに読み取りと書き込みの権限を付与してください。空欄の場合はghを使用します。 | 空欄。このコンピューターにのみ保存されます。 |
実行 & その他
外部ツール用のサードパーティーキー.
| 設定 | 主な機能 | 既定 |
|---|---|---|
Apollo APIキーAPOLLO_API_KEY | Apollo.ioの営業連絡先サービス用のキーで、Apolloアカウント設定のAPIから作成します。Nexus Studioでは使用しないため、独自のツールで読み取る場合を除き空欄にしてください。 | 空欄。このコンピューターにのみ保存されます。 |
スマートフォンの画面の向きNEXUS_EMU_ORIENTATION | スマートフォンでの各実行時の画面を縦向きまたは横向きにします。空欄の場合は、標準の縦向きのままになります。 | Empty |
スマートフォンの位置情報NEXUS_EMU_GEO | スマートフォンが通知する現在地を緯度,経度で指定します(例:4.711,-74.0721)。ページは許可を求めずに取得します。 | Empty |
スマートフォンの言語NEXUS_EMU_LOCALE | スマートフォンが通知する言語と地域です(es-CO や pt-BR など)。空欄の場合は、スマートフォン自体の設定を維持します。 | Empty |
スマートフォンのタイムゾーンNEXUS_EMU_TIMEZONE | スマートフォンが通知するタイムゾーンです(America/Bogota など)。空欄の場合は、このコンピューターの設定を維持します。 | Empty |
スマートフォンのダークモードNEXUS_EMU_COLOR_SCHEME | light、dark、no-preference のいずれかを指定します。ページが認識するスマートフォンの配色設定です。 | Empty |
スマートフォンの視差効果の軽減NEXUS_EMU_REDUCED_MOTION | reduce を指定すると、アニメーションを減らす設定のスマートフォンとしてページに認識されます。no-preference を指定すると、この設定を無効にします。 | Empty |
失敗時に Linear の課題を作成LINEAR_ENABLED | 失敗したテストごとに Linear の課題を 1 件作成し、再び失敗するとコメントを追加し、成功すると課題をクローズします。初期設定では無効です。チケット設定に「linear」の送信先も必要です。 | false |
Linear API キーLINEAR_API_KEY | Linear の個人用 API キーです(Settings → Security & access → Personal API keys)。このコンピューターにのみ保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
Linear のチームLINEAR_TEAM_ID | 課題の送信先となる Linear チームの ID です。送信先ごとに設定を上書きして、別のチームを指定できます。 | Empty |
失敗時に GitLab の課題を作成GITLAB_ISSUES_ENABLED | 失敗したテストごとに GitLab の課題を 1 件作成し、再び失敗するとメモを追加し、成功すると課題をクローズします。初期設定では無効です。チケット設定に「gitlab」の送信先も必要です。 | false |
課題用の GitLab トークンGITLAB_ISSUES_TOKEN | api スコープを持つ GitLab アクセストークンです。ご利用の GitLab に https 経由でのみ送信されます。このコンピューターにのみ保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
課題用の GitLab プロジェクトGITLAB_ISSUES_PROJECT | 課題の送信先となるプロジェクトを、番号または group/name などのパスで指定します。GitLab のアドレスには CI/CD で使用しているものを使います(初期設定は gitlab.com)。 | Empty |
PagerDuty でオンコール担当者に呼び出し通知PAGERDUTY_ENABLED | 失敗したテストごとに PagerDuty のアラートを 1 件発報し、テストが再び成功すると解決済みにします。初期設定では無効です。チケット設定に「pagerduty」の送信先も必要です。 | false |
PagerDuty 連携キーPAGERDUTY_ROUTING_KEY | アラートの送信先となる PagerDuty サービスの Events API v2 連携キーです。このコンピューターにのみ保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
Opsgenie でオンコール担当者にアラート通知OPSGENIE_ENABLED | 失敗したテストごとに Opsgenie のアラートを 1 件作成し、再び失敗するとメモを追加し、成功するとアラートをクローズします。初期設定では無効です。「opsgenie」の送信先も必要です。 | false |
Opsgenie API キーOPSGENIE_API_KEY | アラートの作成とクローズが許可された Opsgenie API キーです。このコンピューターにのみ保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
Opsgenie のリージョンOPSGENIE_API_URL | https://api.opsgenie.com、または Opsgenie アカウントが EU にある場合は https://api.eu.opsgenie.com。 | https://api.opsgenie.com |
結果を TestRail に送信TESTRAIL_ENABLED | 実行が終了するたびに、ケースを指定したテスト(// nexus:testrail C123 コメントがあるもの)をすべて含む TestRail のテスト実行を1件作成し、合格または不合格の結果を送信します。デフォルトでは無効です。 | false |
TestRail アドレスTESTRAIL_URL | https://yourcompany.testrail.io など、お使いの TestRail サイトのアドレス。https のみ使用できます。 | Empty |
TestRail ユーザーTESTRAIL_USER | 結果の送信に使用する TestRail アカウントのメールアドレス。 | Empty |
TestRail API キーTESTRAIL_API_KEY | その TestRail アカウントの API キー(個人設定 → API キー)。このコンピューター内に保存され、保存後は再表示されません。 | 空欄。このコンピューターにのみ保存されます。 |
TestRail プロジェクトTESTRAIL_PROJECT_ID | テスト実行の送信先となる TestRail プロジェクトの番号(アドレス内の P に続く数字のみ)。 | Empty |