PDFリンクをプレビューせず直接ダウンロードする方法

Prev Next

ブラウザの仕様により、PDFリンクをクリックするとプレビュー表示(PDFビューア)が優先され、ファイルがダウンロードされない場合があります。本手順では、ステップをPlaywrightコードに変換し、Altキーを併用したクリックをシミュレートすることで、直接ダウンロードを強制させます。

手順

  1. 対象のシナリオを開く: 編集したいテストシナリオを選択します。

  2. 対象ステップの選択: PDFリンクをクリックしている「クリックステップ」を選択します。

  3. Playwrightコードステップに変換: ステップのメニューから [Playwrightコードステップに変換] を実行します。

  4. コードの修正(Altキーの指定): 表示されたコード内の click メソッドに { modifiers: ['Alt'] } を追加します。

    // 修正前
    await page.getByRole("link", {name: "資料PDF"}).click();
    // 修正後(Altキー併用を指定)
    await page.getByRole("link", {name: "資料PDF"}).click({ modifiers: ['Alt'] }); 
  5. (任意)ダウンロード完了待ちのための待機ステップ追加: Playwrightコードによるクリックアクションは、実行自体が非常に短時間で終了します。 PDFのファイルサイズが大きい場合や、通信環境の影響でダウンロード完了前にテストが終了(または次へ遷移)してしまう場合、コードステップの直後に「待機ステップ(例:5秒〜10秒程度)」を追加してください。

  6. 保存: 画面右上の [保存] をクリックします。

確認方法

シナリオを実行し、該当ステップで以下の挙動を確認します。

  • ブラウザ上でPDFプレビューが開かないこと。

  • ファイルが正常にダウンロードされること。

  • 必要に応じて [テスト結果] の詳細で、該当ステップが正常終了していることを確認します。

留意点

  • ブラウザショートカットの利用: 本手順は「Altキーを押しながらリンクをクリックするとリンク先を保存する」というブラウザの一般的なショートカット動作を利用しています。

  • 待機の判断基準: 通常は待機ステップなしでも動作しますが、実行結果で「ダウンロードが間に合っていない」と思われる挙動(ファイルが未保存のままブラウザが閉じる等)が見られる場合にのみ、手順5の追加をご検討ください。