feat(screen): Add screen export which has all queries bound to the body (#412)

Author: Kent C. Dodds

src/__node_tests__/screen.js

@@ -0,0 +1,9 @@
+import {screen} from '..'
+
+test('the screen export throws a helpful error message when no global document is accessible', () => {
+  expect(() =>
+    screen.getByText(/hello world/i),
+  ).toThrowErrorMatchingInlineSnapshot(
+    `"For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error"`,
+  )
+})

src/__tests__/screen.js

@@ -0,0 +1,9 @@
+import {renderIntoDocument} from './helpers/test-utils'
+import {screen} from '..'
+
+test('exposes queries that are attached to document.body', async () => {
+  renderIntoDocument(`<div>hello world</div>`)
+  screen.getByText(/hello world/i)
+  await screen.findByText(/hello world/i)
+  expect(screen.queryByText(/hello world/i)).not.toBeNull()
+})

src/index.js

@@ -11,6 +11,7 @@ export {getDefaultNormalizer} from './matches'
 export * from './get-node-text'
 export * from './events'
 export * from './get-queries-for-element'
+export * from './screen'
 export * from './query-helpers'
 export {getRoles, logRoles, isInaccessible} from './role-helpers'
 export * from './pretty-dom'

src/screen.js

@@ -0,0 +1,14 @@
+import * as queries from './queries'
+import {getQueriesForElement} from './get-queries-for-element'
+
+export const screen =
+  typeof document !== 'undefined' && document.body
+    ? getQueriesForElement(document.body)
+    : Object.keys(queries).reduce((helpers, key) => {
+        helpers[key] = () => {
+          throw new TypeError(
+            'For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error',
+          )
+        }
+        return helpers
+      }, {})