feat: selectFile and selectFiles API

[criticalbh]

#148

#100

[adieuadieu]

Thank you for raising this PR, @criticalbh.

Two points:

1. We need to think about how this would work over the Proxy. E.g. we might need to add support for uploading from an S3 bucket or other URL. e.g.

await chromeless.selectFile('.uploader', [
  's3://my-bucket/my/object/prefix/file.jpg',
  'http://sweet-site.cool/my-image.jpg'
])

2. I wonder if we could keep the API methods as just one which can take either a single file path string, or an array of file path strings. Maybe something like .selectFileInput(filePathString | array[filePathString])? (I know we've already asked you to change the name once—sorry!) What do you think @schickling @joelgriffith @timsuchanek ?

[schickling]

Sorry for the back and forth on this but I agree with @adieuadieu. We should go with selectFile (or selectFileInput - any other suggestions? @joelgriffith?) and support both a single file and multiple files.

[adieuadieu]

@schickling I lean towards selectFileInput because it's clearer that it has to do with <input type="file"/> than selectFile. But maybe there's a third name which is even clearer.

[joelgriffith]

I'm ready for a bike-shed! selectFileInput is good, but it strikes me as focusing on the file input rather than uploading a file. Following the conventions of thetype API, we could just call it upload (which takes a string of the input-selector and a single file or an array of files).

[adieuadieu]

@joelgriffith Ah shoot. You're right. selectFileInput() does sound like you're selecting the actual file-input field. But, I agree with @schickling that upload() is misleading, too. selectInputFile()?

[criticalbh]

Why not like CDT api -> setFileInputFiles?

[adieuadieu]

@joelgriffith @schickling @criticalbh Naming stuff is hard. Since we sort of liked selectFileInput() but didn't like the part that sounded like we were selecting something, shall we take set from CDPs method and go with setFileInput()?

[schickling]

I like that proposal. Let's do it!

[schickling]

Good to go once we've renamed to setFileInput

[adieuadieu]

Thank you for this PR, @criticalbh!