Page.waitForFileChooser() 方法

此方法通常會與觸發檔案選擇的動作搭配使用。

注意

必須在檔案選擇器啟動之前呼叫此方法。它不會返回目前啟用的檔案選擇器。

注意

目前不支援攔截透過 DOM API（例如 window.showOpenFilePicker）觸發的檔案對話方塊。

簽章

class Page {
  abstract waitForFileChooser(
    options?: WaitTimeoutOptions,
  ): Promise<FileChooser>;
}

參數

參數	類型	描述
options	WaitTimeoutOptions	（選用）

返回

Promise<FileChooser>

備註

在「headful」瀏覽器中，此方法會導致使用者「看不到」原生檔案選擇器對話方塊。

範例

以下範例會點擊一個發出檔案選擇器的按鈕，然後回應 /tmp/myfile.pdf，就像使用者已選取此檔案一樣。

const [fileChooser] = await Promise.all([
  page.waitForFileChooser(),
  page.click('#upload-file-button'),
  // some button that triggers file selection
]);
await fileChooser.accept(['/tmp/myfile.pdf']);