Create best practice for browser module

[ankur22]

What

Currently there are no best practice documentation when it comes to working with the browser module. Within the community and customer base, there's usually some confusion as to how to work with the APIs, which APIs to use, how to work with selectors and how to read the test results.

How

The first step is to start on a best practice doc, and the first topic should be on working with page.waitForTimeout instead of sleep. It should explain:

1. why page.waitForTimeout is better than sleep;
2. when to use it;
3. how to use it with examples;
4. future plans on visualising it in results in our cloud offering.

My tasks

Beta Give feedback

1. Add a page on sleep and wait for browser module #1730
   +0
2. Ensure examples in docs, type definitions and code examples in xk6-browser uses page.waitForTimeout instead of sleep.