diff --git a/package.json b/package.json
index 12bae69..ace4c61 100644
--- a/package.json
+++ b/package.json
@@ -46,5 +46,8 @@
"react": "^0.14.0",
"react-addons-test-utils": "^0.14.0"
},
- "dependencies": {}
+ "dependencies": {
+ "lodash.get": "^3.7.0",
+ "lodash.isequal": "^3.0.4"
+ }
}
diff --git a/specs/find-all-spec.js b/specs/find-all-spec.js
index d3bf66a..ebe356f 100644
--- a/specs/find-all-spec.js
+++ b/specs/find-all-spec.js
@@ -2,40 +2,36 @@ import {findAll} from '../src';
import {createRenderer} from 'react-addons-test-utils';
import React from 'react';
-class OtherComponent extends React.Component {
- render() {
- return (
-
- );
- }
+function OtherComponent() {
+ return (
+
+ );
}
-class TestWithForm extends React.Component {
- render() {
- return (
-
-
-
-
-
-
-
-
Some content
-
+
+
+
+
+
+
+
Some content
+
-
-
-
-
-
-
Some content
-
+
+
+
+
+
+
Some content
+
-
-
-
-
-
Some content
-
-
+
+
+
+
+
Some content
+
+
-
-
- );
- }
+function Test() {
+ return (
+
+
+
+ );
}
describe('`isComponentOfType`', function() {
diff --git a/specs/is-dom-component-spec.js b/specs/is-dom-component-spec.js
index 16a670c..c38d03a 100644
--- a/specs/is-dom-component-spec.js
+++ b/specs/is-dom-component-spec.js
@@ -2,22 +2,18 @@ import {isDOMComponent} from '../src';
import {createRenderer} from 'react-addons-test-utils';
import React from 'react';
-class OtherComponent extends React.Component {
- render() {
- return (
-
- );
- }
+function OtherComponent() {
+ return (
+
+ );
}
-class Test extends React.Component {
- render() {
- return (
-
-
-
- );
- }
+function Test() {
+ return (
+
+
+
+ );
}
describe('`isDOMComponent`', function() {
diff --git a/src/find-all-with-prop.js b/src/find-all-with-prop.js
new file mode 100644
index 0000000..6045f62
--- /dev/null
+++ b/src/find-all-with-prop.js
@@ -0,0 +1,25 @@
+import isEqual from 'lodash.isequal';
+import findAll from './find-all';
+import get from 'lodash.get';
+import React from 'react';
+
+/**
+ * Finds all instances of components in the tree with a prop found at the
+ * `propPath` that matches `propValue`.
+ *
+ * @param {ReactComponent} tree the rendered tree to traverse
+ * @param {String} propPath the prop path to find
+ * @param {*} propValue the prop value to find
+ * @return {Array} all matching components
+ */
+export default function findAllWithProp(tree, propPath, propValue) {
+ return findAll(tree, component => {
+ if (React.isValidElement(component)) {
+ const value = get(component.props, propPath);
+
+ return isEqual(value, propValue);
+ }
+
+ return false;
+ });
+}
diff --git a/src/find-with-class.js b/src/find-with-class.js
index 23f4080..fe267a2 100644
--- a/src/find-with-class.js
+++ b/src/find-with-class.js
@@ -7,6 +7,7 @@ import findAllWithClass from './find-all-with-class';
* This is different to React's `findRenderedDOMComponentWithClass` in that
* it will check *all* components and not just DOM components.
*
+ * @throws Will throw an error if none or more than one component is found.
* @param {ReactComponent} tree the rendered tree to traverse
* @param {String} className the class to find
* @return {ReactComponent} the matching component
diff --git a/src/find-with-prop.js b/src/find-with-prop.js
new file mode 100644
index 0000000..343b5d5
--- /dev/null
+++ b/src/find-with-prop.js
@@ -0,0 +1,21 @@
+import findAllWithProp from './find-all-with-prop';
+
+/**
+ * Find only one instance of a component in the tree with a prop found at the
+ * `propPath` that matches `propValue`.
+ *
+ * @throws Will throw an error if none or more than one component is found.
+ * @param {ReactComponent} tree the rendered tree to traverse
+ * @param {String} propPath the prop path to find
+ * @param {*} propValue the prop value to find
+ * @return {ReactComponent} the matching component
+ */
+export default function findWithProp(root, propPath, propValue) {
+ const found = findAllWithProp(root, propPath, propValue);
+
+ if (found.length !== 1) {
+ throw new Error(`Did not find exactly once match for prop: ${propPath}, with value: ${propValue}`);
+ }
+
+ return found[0];
+}
diff --git a/src/find-with-ref.js b/src/find-with-ref.js
index e03cf12..3e444e1 100644
--- a/src/find-with-ref.js
+++ b/src/find-with-ref.js
@@ -5,6 +5,7 @@ import findAll from './find-all';
* Finds component in the tree with a ref that matches
* `ref`.
*
+ * @throws Will throw an error if none or more than one component is found.
* @param {ReactComponent} tree the rendered tree to traverse
* @param {String} ref to find
* @return {ReactComponent} found component
diff --git a/src/find-with-type.js b/src/find-with-type.js
index bfea626..8642e85 100644
--- a/src/find-with-type.js
+++ b/src/find-with-type.js
@@ -8,6 +8,7 @@ import findAllWithType from './find-all-with-type';
* `findRenderedComponentWithType` as you can supply a component class or a
* DOM tag.
*
+ * @throws Will throw an error if none or more than one component is found.
* @param {ReactComponent} tree the rendered tree to traverse
* @param {Function|String} type the component type or tag to find
* @return {ReactComponent} the matching component
diff --git a/src/index.js b/src/index.js
index bdddcd0..88deaa7 100644
--- a/src/index.js
+++ b/src/index.js
@@ -1,7 +1,9 @@
export findAll from './find-all';
export findAllWithClass from './find-all-with-class';
+export findAllWithProp from './find-all-with-prop';
export findAllWithType from './find-all-with-type';
export findWithClass from './find-with-class';
+export findWithProp from './find-with-prop';
export findWithRef from './find-with-ref';
export findWithType from './find-with-type';
export getMountedInstance from './get-mounted-instance';