Add setInputFiles docs for browser module

[ankur22]

What?

Add setInputFiles docs for browser module. The API is available in frame, page and elementHandle.

Checklist

• I have used a meaningful title for the PR.
• I have described the changes I've made in the "What?" section above.
• I have performed a self-review of my changes.
• I have run the npm start command locally and verified that the changes look good.

• I have made my changes in the docs/sources/next folder of the documentation.

Related PR(s)/Issue(s)

grafana/xk6-browser#1097 & grafana/xk6-browser#1244

[heitortsergent]

Just some minor style nits, and a question about the example. 🙏

[heitortsergent]

Where would this file have to be for this example to work?

[ankur22]

The file is inline in the code i.e. it's all there in the object (name, mimetype and buffer). This new API doesn't work with the local filesystem at all. A user will need to work with the experimental FS module to do that.

[ankur22]

@heitortsergent i'm merging this into make the next release, but please add any more suggestions and I will add them to a new PR.

[heitortsergent]

@ankur22 I think it would be great if we had an example with a real use case, whether that's using the experimental fs module, or any other use case we think might be common.

What do you think? I could open a separate issue for it.

[ankur22]

@ankur22 I think it would be great if we had an example with a real use case, whether that's using the experimental fs module, or any other use case we think might be common.

That's a good idea, and I already have one ready to be added into the docs. I'll create a PR soon.

[heitortsergent]

@ankur22 thank you!! 🙇