Documenting get method on wrapper #1298

Author: tomasbjerre

docs/README.md

@@ -44,6 +44,7 @@ Vue Test Utils is the official unit testing utility library for Vue.js.
     - [destroy](api/wrapper/destroy.md)
     - [find](api/wrapper/find.md)
     - [findAll](api/wrapper/findAll.md)
+    - [get](api/wrapper/get.md)
     - [html](api/wrapper/html.md)
     - [is](api/wrapper/is.md)
     - [isEmpty](api/wrapper/isEmpty.md)

docs/api/wrapper/README.md

@@ -36,6 +36,7 @@ A `Wrapper` is an object that contains a mounted component or vnode and methods
 !!!include(docs/api/wrapper/find.md)!!!
 !!!include(docs/api/wrapper/findAll.md)!!!
 !!!include(docs/api/wrapper/html.md)!!!
+!!!include(docs/api/wrapper/get.md)!!!
 !!!include(docs/api/wrapper/is.md)!!!
 !!!include(docs/api/wrapper/isEmpty.md)!!!
 !!!include(docs/api/wrapper/isVisible.md)!!!

docs/api/wrapper/get.md

@@ -0,0 +1,19 @@
+## get
+
+Works just like [find](../find.md) but will throw an error if selector not
+matching anything. You should use `find` when searching for an element that
+may not exist. You should use this method when getting an element that should
+exist and it will provide a nice error message if that is not the case.
+
+```js
+import { mount } from '@vue/test-utils'
+
+const wrapper = mount(Foo)
+
+expect(() => wrapper.get('.does-not-exist'))
+  .to.throw()
+  .with.property(
+    'message',
+    'Unable to find .does-not-exist within: <div>the actual DOM here...</div>'
+  )
+```