Updated docs about label. Updated detox init script.

README.md

@@ -28,7 +28,7 @@ describe('Login flow', () => {
     await element(by.id('password')).typeText('123456');
     await element(by.label('Login')).tap();
 
-    await expect(element(by.label('Welcome'))).toBeVisible();
+    await expect(element(by.text('Welcome'))).toBeVisible();
     await expect(element(by.id('email'))).toNotExist();
   });
 

detox/local-cli/templates/mocha.js

@@ -10,12 +10,12 @@ const firstTestContent = `describe('Example', () => {
   
   it('should show hello screen after tap', async () => {
     await element(by.id('hello_button')).tap();
-    await expect(element(by.label('Hello!!!'))).toBeVisible();
+    await expect(element(by.text('Hello!!!'))).toBeVisible();
   });
   
   it('should show world screen after tap', async () => {
     await element(by.id('world_button')).tap();
-    await expect(element(by.label('World!!!'))).toBeVisible();
+    await expect(element(by.text('World!!!'))).toBeVisible();
   });
 })`
 const initjsContent = `require('babel-polyfill');

detox/src/android/expect.js

@@ -283,7 +283,7 @@ class ExpectElement extends Expect {
     return await new MatcherAssertionInteraction(this._element, new TextMatcher(value)).execute();
   }
   async toHaveLabel(value) {
-    return await new MatcherAssertionInteraction(this._element, new TextMatcher(value)).execute();
+    return await new MatcherAssertionInteraction(this._element, new LabelMatcher(value)).execute();
   }
   async toHaveId(value) {
     return await new MatcherAssertionInteraction(this._element, new IdMatcher(value)).execute();

docs/APIRef.Expect.md

@@ -11,6 +11,7 @@ Expect verifies if a certain value is as expected to be.
 - [`.toExist()`](#toexist)
 - [`.toNotExist()`](#tonotexist)
 - [`.toHaveText()`](#tohavetexttext)
+- [`.toHaveLabel()`](#tohavelabellabel)
 - [`.toHaveId()`](#tohaveidid)
 - [`.toHaveValue()`](#tohavevaluevalue)
 
@@ -52,6 +53,13 @@ await expect(element(by.id('RandomJunk959'))).toNotExist();
 await expect(element(by.id('UniqueId204'))).toHaveText('I contain some text');
 ```
 
+### `toHaveLabel(label)`
+- Similar to `toHaveText(text)`, but searches by accessibilityLabel (iOS) or by contentDescription (Android)
+
+```js
+await expect(element(by.id('UniqueId204'))).toHaveLabel('Done');
+```
+
 ### `toHaveId(id)`
 - In React Native apps, expect UI component to have [`testID`](https://facebook.github.io/react-native/docs/view.html#testid) with that id.
 - In native iOS apps, expect UI element to have accesibilityIdentifier with that id.

docs/APIRef.Matchers.md

@@ -11,6 +11,7 @@ Matchers find elements in your app that match one or more properties.
 
 - [`by.id()`](#byidid)
 - [`by.text()`](#bytexttext)
+- [`by.label()`](#bylabellabel)
 - [`by.type()`](#bytypenativeviewtype)
 - [`by.traits()`](#bytraitstraits)
 
@@ -42,14 +43,22 @@ Find an element by text, useful for text fields, buttons.
 ```js
 await element(by.text('Tap Me'));
 ```
+
+#### `by.label(label)`
+Find an element by accessibilityLabel(iOS) or contentDescription(Android), useful for text fields, buttons.
+
+```js
+await element(by.label('Welcome'));
+```
+
 #### `by.type(nativeViewType)`
 Find an element by native view type.
 
 ```js
 await element(by.type('RCTImageView'));
 ```
 #### `by.traits([traits])`
-Find an element with an accessibility trait.
+Find an element with an accessibility trait. (iOS only)
 
 ```js
 await element(by.traits(['button']));

docs/Troubleshooting.RunningTests.md

@@ -125,7 +125,7 @@ render() {
 
 ```js
 await element(by.label('Login')).tap();
-await expect(element(by.label('Welcome'))).toBeVisible();
+await expect(element(by.text('Welcome'))).toBeVisible();
 ```
 
 In the test above, after tapping the Login button, the app performs several complex asynchronous operations until the Welcome message is displayed post-login. These can include querying a server, waiting for a response and then running an animated transition to the Welcome screen. Detox attempts to simplify your test code by synchronizing *automatically* with these asynchronous operations. What happens if for some reason the automatic synchronization doesn't work? As a result, Detox will not wait correctly until the Welcome screen appears and instead will continue immediately to the next line and try to run the expectation. Since the screen is not there yet, the test will fail.
@@ -136,7 +136,7 @@ Full documentation about `waitFor` is available [here](/docs/APIRef.waitFor.md).
 
 ```js
 await element(by.label('Login')).tap();
-await waitFor(element(by.label('Welcome'))).toBeVisible().withTimeout(2000);
+await waitFor(element(by.text('Welcome'))).toBeVisible().withTimeout(2000);
 ```
 
 <br>

examples/demo-native-android/e2e/example.spec.js

@@ -5,19 +5,19 @@ describe('Example', function () {
   });
 
   it('should have welcome screen', function () {
-    expect(element(by.label('Welcome'))).toBeVisible();
-    expect(element(by.label('Say Hello'))).toBeVisible();
-    expect(element(by.label('Say World'))).toBeVisible();
+    expect(element(by.text('Welcome'))).toBeVisible();
+    expect(element(by.text('Say Hello'))).toBeVisible();
+    expect(element(by.text('Say World'))).toBeVisible();
   });
 
   it('should show hello screen after tap', function () {
-    element(by.label('Say Hello')).tap();
-    expect(element(by.label('Hello!!!'))).toBeVisible();
+    element(by.text('Say Hello')).tap();
+    expect(element(by.text('Hello!!!'))).toBeVisible();
   });
 
   it('should show world screen after tap', function () {
-    element(by.label('Say World')).tap();
-    expect(element(by.label('World!!!'))).toBeVisible();
+    element(by.text('Say World')).tap();
+    expect(element(by.text('World!!!'))).toBeVisible();
   });
 
 });

examples/demo-react-native/e2e/example.spec.js

@@ -9,11 +9,11 @@ describe('Example', () => {
 
   it('should show hello screen after tap', async () => {
     await element(by.id('hello_button')).tap();
-    await expect(element(by.label('Hello!!!'))).toBeVisible();
+    await expect(element(by.text('Hello!!!'))).toBeVisible();
   });
 
   it('should show world screen after tap', async () => {
     await element(by.id('world_button')).tap();
-    await expect(element(by.label('World!!!'))).toBeVisible();
+    await expect(element(by.text('World!!!'))).toBeVisible();
   });
 });