Merge pull request #4405 from wix/docs/fix-brackets

docs(webviews): fix brackets position in API example, improve guide.

docs/api/webviews.md

@@ -44,7 +44,7 @@ This matcher is available for iOS only. See [this GitHub issue](https://github.c
 If you have multiple web views on the screen and you want to interact with a specific web view, you can use the `atIndex()` method to choose the web view at the specified index.
 
 ```js
-const myWebView = web(by.id('webview_identifier').atIndex(1));
+const myWebView = web(by.id('webview_identifier')).atIndex(1);
 const innerElement = myWebView.element(by.web.id('inner_element_identifier'));
 await expect(innerElement).toHaveText('Hello World!');
 ```
@@ -146,7 +146,7 @@ web.element(by.web.tag('h1'));
 Choose the element at the specified index.
 
 ```js
-web.element(by.web.tag('h1').atIndex(1));
+web.element(by.web.tag('h1')).atIndex(1);
 ```
 
 Use it sparingly for those rare cases when you cannot make your matcher less ambiguous, so it returns one element only.

docs/guide/testing-webviews.md

@@ -102,8 +102,22 @@ const textElement = web(by.id('webview_identifier')).element(by.web.id('text_ele
 const fontSize = await textElement.runScript(function get(element) {
   return element.style.fontSize;
 });
+
+// Use jestExpect to assert the font size
+jestExpect(fontSize).toBe('16px');
 ```
 
+:::note
+
+Using jest-expectations in Detox tests is possible by importing `expect` API from `jest` package and using it with a separate `jestExpect` variable (as shown in the example below).
+This is due to the fact that Detox uses its own `expect` API, which is not compatible with jest-expectations.
+
+```javascript
+const jestExpect = require('expect').default;
+```
+
+:::
+
 ## Step 4: Assert on Expected Behaviour
 
 Expectations are assertions on the state of elements within a WebView.