Add key method

docs/README.md

@@ -36,6 +36,7 @@
     * [html()](/docs/api/ShallowWrapper/html.md)
     * [instance()](/docs/api/ShallowWrapper/instance.md)
     * [is(selector)](/docs/api/ShallowWrapper/is.md)
+    * [key()](/docs/api/ShallowWrapper/key.md)
     * [last()](/docs/api/ShallowWrapper/last.md)
     * [map(fn)](/docs/api/ShallowWrapper/map.md)
     * [not(selector)](/docs/api/ShallowWrapper/not.md)
@@ -80,6 +81,7 @@
     * [html()](/docs/api/ReactWrapper/html.md)
     * [instance()](/docs/api/ReactWrapper/instance.md)
     * [is(selector)](/docs/api/ReactWrapper/is.md)
+    * [key()](/docs/api/ReactWrapper/key.md)
     * [last()](/docs/api/ReactWrapper/last.md)
     * [map(fn)](/docs/api/ReactWrapper/map.md)
     * [mount()](/docs/api/ReactWrapper/mount.md)

docs/api/ReactWrapper/key.md

@@ -0,0 +1,18 @@
+# `.key() => String`
+
+Returns the key value for the node of the current wrapper.
+
+NOTE: can only be called on a wrapper of a single node.
+
+#### Example
+
+
+```jsx
+const wrapper = mount(
+  <ul>
+    {['foo', 'bar'].map(s => <li key={s}>{s}</li>)}
+  </ul>
+).find('li');
+expect(wrapper.at(0).key()).to.equal('foo');
+expect(wrapper.at(1).key()).to.equal('bar');
+```

docs/api/ShallowWrapper/key.md

@@ -0,0 +1,18 @@
+# `.key() => String`
+
+Returns the key value for the node of the current wrapper.
+
+NOTE: can only be called on a wrapper of a single node.
+
+#### Example
+
+
+```jsx
+const wrapper = shallow(
+  <ul>
+    {['foo', 'bar'].map(s => <li key={s}>{s}</li>)}
+  </ul>
+).find('li');
+expect(wrapper.at(0).key()).to.equal('foo');
+expect(wrapper.at(1).key()).to.equal('bar');
+```

docs/api/mount.md

@@ -129,6 +129,9 @@ Returns the props of the root component.
 #### [`.prop(key) => Any`](ReactWrapper/prop.md)
 Returns the named prop of the root component.
 
+#### [`.key() => String`](ReactWrapper/key.md)
+Returns the key of the root component.
+
 #### [`.simulate(event[, data]) => ReactWrapper`](ReactWrapper/simulate.md)
 Simulates an event on the current node.
 

docs/api/shallow.md

@@ -136,6 +136,9 @@ Returns the props of the root component.
 #### [`.prop(key) => Any`](ShallowWrapper/prop.md)
 Returns the named prop of the root component.
 
+#### [`.key() => String`](ShallowWrapper/key.md)
+Returns the key of the root component.
+
 #### [`.simulate(event[, data]) => ShallowWrapper`](ShallowWrapper/simulate.md)
 Simulates an event on the current node.
 

src/ReactWrapper.js

@@ -498,7 +498,16 @@ export default class ReactWrapper {
   }
 
   /**
-   * Returns the type of the root ndoe of this wrapper. If it's a composite component, this will be
+   * Returns the key assigned to the current node.
+   *
+   * @returns {String}
+   */
+  key() {
+    return this.single((n) => getNode(n).key);
+  }
+
+  /**
+   * Returns the type of the root node of this wrapper. If it's a composite component, this will be
    * the component constructor. If it's native DOM node, it will be a string.
    *
    * @returns {String|Function}

src/ShallowWrapper.js

@@ -486,7 +486,16 @@ export default class ShallowWrapper {
   }
 
   /**
-   * Returns the type of the root ndoe of this wrapper. If it's a composite component, this will be
+   * Returns the key assigned to the current node.
+   *
+   * @returns {String}
+   */
+  key() {
+    return this.single((n) => n.key);
+  }
+
+  /**
+   * Returns the type of the root node of this wrapper. If it's a composite component, this will be
    * the component constructor. If it's native DOM node, it will be a string.
    *
    * @returns {String|Function}

test/ReactWrapper-spec.js

@@ -1884,4 +1884,16 @@ describeWithDOM('mount', () => {
     expect(rendered.length).to.equal(0);
     expect(rendered.html()).to.equal(null);
   });
+
+  describe('.key()', () => {
+    it('should return the key of the node', () => {
+      const wrapper = mount(
+          <ul>
+            {['foo', 'bar'].map(s => <li key={s}>{s}</li>)}
+          </ul>
+      ).find('li');
+      expect(wrapper.at(0).key()).to.equal('foo');
+      expect(wrapper.at(1).key()).to.equal('bar');
+    });
+  });
 });

test/ShallowWrapper-spec.js

@@ -2232,4 +2232,16 @@ describe('shallow', () => {
     });
   });
 
+  describe('.key()', () => {
+    it('should return the key of the node', () => {
+      const wrapper = shallow(
+        <ul>
+          {['foo', 'bar'].map(s => <li key={s}>{s}</li>)}
+        </ul>
+      ).find('li');
+      expect(wrapper.at(0).key()).to.equal('foo');
+      expect(wrapper.at(1).key()).to.equal('bar');
+    });
+  });
+
 });