browserFileUpload
Upload files to a specified input element using page ID and XPath reference, with configurable wait time for snapshots in browser automation.
Instructions
上传文件到指定元素
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageId | Yes | 页面ID | |
| paths | Yes | 要上传的文件路径数组 | |
| ref | Yes | 文件输入元素的xp引用值 | |
| waitForTimeout | No | 操作后等待获取快照的延迟时间（毫秒，默认2000） |
Implementation Reference
- lib/tools/files.js:18-44 (registration)Defines and exports the browser_file_upload tool using defineTabTool, which likely registers it as a tab tool.
const uploadFile = defineTabTool({ capability: 'core', schema: { name: 'browser_file_upload', title: 'Upload files', description: 'Upload one or multiple files', inputSchema: z.object({ paths: z.array(z.string()).describe('The absolute paths to the files to upload. Can be a single file or multiple files.'), }), type: 'destructive', }, handle: async (tab, params, response) => { response.setIncludeSnapshot(); const modalState = tab.modalStates().find(state => state.type === 'fileChooser'); if (!modalState) throw new Error('No file chooser visible'); response.addCode(`await fileChooser.setFiles(${JSON.stringify(params.paths)})`); tab.clearModalState(modalState); await tab.waitForCompletion(async () => { await modalState.fileChooser.setFiles(params.paths); }); }, clearsModalState: 'fileChooser', }); export default [ uploadFile, ]; - lib/tools/files.js:29-39 (handler)The handler function that finds the file chooser modal and sets the files from params.paths, clears the modal state, and waits for completion.
handle: async (tab, params, response) => { response.setIncludeSnapshot(); const modalState = tab.modalStates().find(state => state.type === 'fileChooser'); if (!modalState) throw new Error('No file chooser visible'); response.addCode(`await fileChooser.setFiles(${JSON.stringify(params.paths)})`); tab.clearModalState(modalState); await tab.waitForCompletion(async () => { await modalState.fileChooser.setFiles(params.paths); }); }, - lib/tools/files.js:20-28 (schema)Tool schema defining name 'browser_file_upload', input schema expecting array of file paths, marked as destructive.
schema: { name: 'browser_file_upload', title: 'Upload files', description: 'Upload one or multiple files', inputSchema: z.object({ paths: z.array(z.string()).describe('The absolute paths to the files to upload. Can be a single file or multiple files.'), }), type: 'destructive', },