add method for finds ancestor of located element

docs/locators.md

@@ -174,6 +174,15 @@ locate('#table td').at(2);
 locate('#table td').at(-2);
 ```
 
+#### parent
+
+Finds an element that is the ancestor of the located:
+
+```js
+// finds `form#user_profile' as the parent element of 'div`
+locate('select').parent('form#user_profile');
+```
+
 #### inside
 
 Finds an element which contains an provided ancestor:

lib/locator.js

@@ -160,6 +160,11 @@ class Locator {
     return this;
   }
 
+  parent(locator) {
+    const xpath = sprintf('%s//ancestor::%s', this.toXPath(), removePrefix((new Locator(locator, 'css')).toXPath()));
+    return new Locator({ xpath });
+  }
+
   inside(locator) {
     const xpath = sprintf('%s[ancestor::%s]', this.toXPath(), removePrefix((new Locator(locator, 'css')).toXPath()));
     return new Locator({ xpath });

test/unit/locator_test.js

@@ -96,6 +96,16 @@ describe('Locator', () => {
     expect(nodes[0].firstChild.data).to.eql('Show');
   });
 
+  it('should parent select a by label', () => {
+    const l = Locator.build('a')
+      .withAttr({ href: '#' })
+      .parent(Locator.build('label').withText('Hello'));
+
+    const nodes = xpath.select(l.toXPath(), doc);
+    expect(nodes).to.have.length(1, l.toXPath());
+    expect(nodes[0].firstChild.data).to.eql('Hello', l.toXPath());
+  });
+
   it('should select a by label', () => {
     const l = Locator.build('a')
       .withAttr({ href: '#' })