setInputFiles

Sets files for a file input element (<input type="file">). The element is identified using one of the provided selector strategies. Can be used to simulate file uploads. Example: setInputFiles(selector: "input[type='file']", files: [{ name: "file.txt", mimeType: "text/plain", data: "SGVsbG8gd29ybGQ=" }]) The data field should be Base64 encoded content of the file. Returns true if the files were successfully set.

​

Definition

setInputFiles(
  selector: String
  text: String
  role: String
  label: String
  placeholder: String
  altText: String
  title: String
  testId: String
  filter: ElementFilterOptions
  files: [InputFileOptions]!
): Boolean!

​

Arguments

​

selector: String

The CSS selector for the element. Example: "#username" for <input id="username" />.

​

text: String

Finds an element by its text content. Example: "Login" for <button>Login</button>.

​

role: String

Finds an element by its ARIA role. Example: "button" for <div role="button">Submit</div>.

​

label: String

Finds an element by its ARIA label. Example: "Search button" for <button aria-label="Search button"><svg/></button>.

​

placeholder: String

Finds an element by its placeholder text. Example: "Enter your email" for <input placeholder="Enter your email" />.

​

altText: String

Finds an element by its image alt text. Example: "Company logo" for <img alt="Company logo" src="..." />.

​

title: String

Finds an element by its title attribute. Example: "Close dialog" for <span title="Close dialog">X</span>.

​

testId: String

Finds an element by its data-testid attribute. Example: "submit-button" for <button data-testid="submit-button">Go</button>.

​

filter: ElementFilterOptions

Advanced filtering options for the element.

​

files: [InputFileOptions]!

An array of file objects to set for the input. Each file needs a name, mimeType, and base64 encoded data.

​

Returns

Boolean!

The Boolean scalar type represents true or false.