Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: emberjs/ember-test-helpers
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 56072c5df9f926cceb3eaac786555a7f54fd7250
Choose a base ref
...
head repository: emberjs/ember-test-helpers
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: 8b276a01a3e278778983e480a9945e213c185344
Choose a head ref

Commits on Nov 18, 2019

  1. [Security] Bump https-proxy-agent from 2.2.1 to 2.2.4

    Bumps [https-proxy-agent](https://github.com/TooTallNate/node-https-proxy-agent) from 2.2.1 to 2.2.4. **This update includes security fixes.**
    - [Release notes](https://github.com/TooTallNate/node-https-proxy-agent/releases)
    - [Commits](TooTallNate/proxy-agents@2.2.1...2.2.4)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Nov 18, 2019
    Copy the full SHA
    3d694e5 View commit details
  2. Copy the full SHA
    f053fe0 View commit details

Commits on Nov 22, 2019

  1. Bump ember-source from 3.10.1 to 3.14.2 (#739)

    Bumps [ember-source](https://github.com/emberjs/ember.js) from 3.10.1 to 3.14.2.
    - [Release notes](https://github.com/emberjs/ember.js/releases)
    - [Changelog](https://github.com/emberjs/ember.js/blob/v3.14.2/CHANGELOG.md)
    - [Commits](emberjs/ember.js@v3.10.1...v3.14.2)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored and Turbo87 committed Nov 22, 2019
    Copy the full SHA
    538e4b7 View commit details
  2. Drop support for Node 6

    Turbo87 committed Nov 22, 2019
    Copy the full SHA
    d8bf49f View commit details
  3. Copy the full SHA
    8306924 View commit details
  4. [Security] Bump lodash.merge from 4.6.1 to 4.6.2

    Bumps [lodash.merge](https://github.com/lodash/lodash) from 4.6.1 to 4.6.2. **This update includes security fixes.**
    - [Release notes](https://github.com/lodash/lodash/releases)
    - [Commits](https://github.com/lodash/lodash/commits)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] committed Nov 22, 2019
    Copy the full SHA
    f4b5227 View commit details
  5. Copy the full SHA
    7d8a9a5 View commit details

Commits on Dec 4, 2019

  1. Only require ember-cli-typescript while developing (#610)

    Only require ember-cli-typescript while developing
    rwjblue authored Dec 4, 2019
    Copy the full SHA
    1eb82f9 View commit details

Commits on Dec 6, 2019

  1. Copy the full SHA
    aa061b7 View commit details
  2. Copy the full SHA
    9738f74 View commit details

Commits on Dec 7, 2019

  1. Merge pull request #745 from Turbo87/logging

    Implement test helper logging
    Turbo87 authored Dec 7, 2019
    Copy the full SHA
    c496820 View commit details

Commits on Dec 12, 2019

  1. Copy the full SHA
    ee412cc View commit details
  2. fix typeIn documentation example

    the example was missing the selector string
    
    replaces #742
    craigteegarden authored Dec 12, 2019
    Copy the full SHA
    a198fc0 View commit details

Commits on Dec 16, 2019

  1. fix typeIn documentation example (#751)

    fix `typeIn` documentation example
    rwjblue authored Dec 16, 2019
    Copy the full SHA
    2e460e4 View commit details

Commits on Dec 22, 2019

  1. Merge pull request #744 from Turbo87/node-6

    Drop support for Node 6
    Turbo87 authored Dec 22, 2019
    Copy the full SHA
    e585ae2 View commit details
  2. Bump ember-cli from 3.8.2 to 3.15.1

    Bumps [ember-cli](https://github.com/ember-cli/ember-cli) from 3.8.2 to 3.15.1.
    - [Release notes](https://github.com/ember-cli/ember-cli/releases)
    - [Changelog](https://github.com/ember-cli/ember-cli/blob/v3.15.1/CHANGELOG.md)
    - [Commits](ember-cli/ember-cli@v3.8.2...v3.15.1)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 22, 2019
    Copy the full SHA
    6af7832 View commit details
  3. [Security] Bump eslint-utils from 1.3.1 to 1.4.3

    Bumps [eslint-utils](https://github.com/mysticatea/eslint-utils) from 1.3.1 to 1.4.3. **This update includes security fixes.**
    - [Release notes](https://github.com/mysticatea/eslint-utils/releases)
    - [Commits](mysticatea/eslint-utils@v1.3.1...v1.4.3)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 22, 2019
    Copy the full SHA
    840ca27 View commit details
  4. [Security] Bump mixin-deep from 1.3.1 to 1.3.2

    Bumps [mixin-deep](https://github.com/jonschlinkert/mixin-deep) from 1.3.1 to 1.3.2. **This update includes a security fix.**
    - [Release notes](https://github.com/jonschlinkert/mixin-deep/releases)
    - [Commits](jonschlinkert/mixin-deep@1.3.1...1.3.2)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 22, 2019
    Copy the full SHA
    613489f View commit details
  5. Copy the full SHA
    2f91f73 View commit details
  6. Copy the full SHA
    7ebed9f View commit details
  7. Bump eslint-plugin-node from 8.0.1 to 10.0.0

    Bumps [eslint-plugin-node](https://github.com/mysticatea/eslint-plugin-node) from 8.0.1 to 10.0.0.
    - [Release notes](https://github.com/mysticatea/eslint-plugin-node/releases)
    - [Commits](mysticatea/eslint-plugin-node@v8.0.1...v10.0.0)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 22, 2019
    Copy the full SHA
    65452e0 View commit details
  8. Copy the full SHA
    eeebc21 View commit details
  9. Copy the full SHA
    2ebf833 View commit details

Commits on Dec 23, 2019

  1. Bump ember-try from 1.2.1 to 1.4.0

    Bumps [ember-try](https://github.com/ember-cli/ember-try) from 1.2.1 to 1.4.0.
    - [Release notes](https://github.com/ember-cli/ember-try/releases)
    - [Changelog](https://github.com/ember-cli/ember-try/blob/master/CHANGELOG.md)
    - [Commits](ember-cli/ember-try@v1.2.1...v1.4.0)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 23, 2019
    Copy the full SHA
    88212fe View commit details
  2. Copy the full SHA
    476b36f View commit details
  3. Copy the full SHA
    b907fc3 View commit details
  4. Copy the full SHA
    748b619 View commit details
  5. Bump ember-resolver from 5.1.3 to 7.0.0 (#758)

    Bumps [ember-resolver](https://github.com/ember-cli/ember-resolver) from 5.1.3 to 7.0.0.
    - [Release notes](https://github.com/ember-cli/ember-resolver/releases)
    - [Changelog](https://github.com/ember-cli/ember-resolver/blob/master/CHANGELOG.md)
    - [Commits](ember-cli/ember-resolver@v5.1.3...v7.0.0)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored and Turbo87 committed Dec 23, 2019
    Copy the full SHA
    f23a798 View commit details
  6. Bump ember-source-channel-url from 1.1.0 to 2.0.1

    Bumps [ember-source-channel-url](https://github.com/rwjblue/ember-source-channel-url) from 1.1.0 to 2.0.1.
    - [Release notes](https://github.com/rwjblue/ember-source-channel-url/releases)
    - [Commits](ember-cli/ember-source-channel-url@v1.1.0...v2.0.1)
    
    Signed-off-by: dependabot[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Dec 23, 2019
    Copy the full SHA
    0fa2619 View commit details

Commits on Dec 25, 2019

  1. Copy the full SHA
    dab41fb View commit details
  2. Copy the full SHA
    568a009 View commit details

Commits on Jan 24, 2020

  1. Copy the full SHA
    7b0584c View commit details
  2. punctuation

    jenweber committed Jan 24, 2020
    Copy the full SHA
    ac98870 View commit details

Commits on Feb 5, 2020

  1. Merge pull request #750 from emberjs/waitfor-until-docs

    Add examples to `waitUntil` and `waitFor`
    rwjblue authored Feb 5, 2020
    Copy the full SHA
    e609749 View commit details

Commits on Feb 21, 2020

  1. Bump broccoli-funnel from 2.0.2 to 3.0.2

    Bumps [broccoli-funnel](https://github.com/broccolijs/broccoli-funnel) from 2.0.2 to 3.0.2.
    - [Release notes](https://github.com/broccolijs/broccoli-funnel/releases)
    - [Changelog](https://github.com/broccolijs/broccoli-funnel/blob/master/CHANGELOG.md)
    - [Commits](broccolijs/broccoli-funnel@v2.0.2...v3.0.2)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Feb 21, 2020
    Copy the full SHA
    b26ffac View commit details

Commits on Feb 26, 2020

  1. Drop support for Node 8

    Turbo87 committed Feb 26, 2020
    Copy the full SHA
    02a210e View commit details
  2. Copy the full SHA
    a5f59e4 View commit details

Commits on Apr 17, 2020

  1. Merge pull request #775 from Turbo87/node-8

    Drop support for Node 8
    Turbo87 authored Apr 17, 2020
    Copy the full SHA
    3bc68d2 View commit details
  2. Copy the full SHA
    dd4ea7b View commit details
  3. Bump typescript from 3.6.4 to 3.8.3

    Bumps [typescript](https://github.com/Microsoft/TypeScript) from 3.6.4 to 3.8.3.
    - [Release notes](https://github.com/Microsoft/TypeScript/releases)
    - [Commits](microsoft/TypeScript@v3.6.4...v3.8.3)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Apr 17, 2020
    Copy the full SHA
    b2564f2 View commit details
  4. Copy the full SHA
    8bffa5a View commit details
  5. Copy the full SHA
    cb64a1e View commit details
  6. Bump qunit from 2.9.2 to 2.9.3

    Bumps [qunit](https://github.com/qunitjs/qunit) from 2.9.2 to 2.9.3.
    - [Release notes](https://github.com/qunitjs/qunit/releases)
    - [Changelog](https://github.com/qunitjs/qunit/blob/master/History.md)
    - [Commits](qunitjs/qunit@2.9.2...2.9.3)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Apr 17, 2020
    Copy the full SHA
    e19edbe View commit details
  7. Copy the full SHA
    e399ab0 View commit details
  8. Copy the full SHA
    978f1b2 View commit details
  9. Bump prettier from 1.17.1 to 2.0.4

    Bumps [prettier](https://github.com/prettier/prettier) from 1.17.1 to 2.0.4.
    - [Release notes](https://github.com/prettier/prettier/releases)
    - [Changelog](https://github.com/prettier/prettier/blob/master/CHANGELOG.md)
    - [Commits](prettier/prettier@1.17.1...2.0.4)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored Apr 17, 2020
    Copy the full SHA
    446ebf0 View commit details

Commits on Apr 19, 2020

  1. Prettier: Set arrowParens option to avoid

    to match prettier@1 behavior
    Turbo87 committed Apr 19, 2020
    Copy the full SHA
    49a8ae7 View commit details
  2. Fix prettier issues

    Turbo87 committed Apr 19, 2020
    Copy the full SHA
    fe16c5b View commit details
  3. 3
    Copy the full SHA
    2dd71cf View commit details
  4. Bump ember-test-waiters from 1.1.1 to 2.0.1

    Bumps [ember-test-waiters](https://github.com/emberjs/ember-test-waiters) from 1.1.1 to 2.0.1.
    - [Release notes](https://github.com/emberjs/ember-test-waiters/releases)
    - [Changelog](https://github.com/emberjs/ember-test-waiters/blob/master/CHANGELOG.md)
    - [Commits](emberjs/ember-test-waiters@v1.1.1...v2.0.1)
    
    Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
    dependabot-preview[bot] authored and Turbo87 committed Apr 19, 2020
    Copy the full SHA
    3670321 View commit details
Showing with 7,997 additions and 9,340 deletions.
  1. +4 −4 .eslintrc.js
  2. +67 −0 .github/workflows/ci-build.yml
  3. +1 −0 .prettierrc.js
  4. +0 −85 .travis.yml
  5. +21 −1 API.md
  6. +209 −0 CHANGELOG.md
  7. +9 −2 README.md
  8. +19 −22 RELEASE.md
  9. +107 −0 addon-test-support/@ember/test-helpers/-internal/build-registry.ts
  10. +5 −5 addon-test-support/@ember/test-helpers/-internal/debug-info.ts
  11. +63 −0 addon-test-support/@ember/test-helpers/-internal/helper-hooks.ts
  12. +1 −1 addon-test-support/@ember/test-helpers/build-owner.ts
  13. +39 −0 addon-test-support/@ember/test-helpers/dom/-guard-for-maxlength.ts
  14. +7 −9 addon-test-support/@ember/test-helpers/dom/-is-focusable.ts
  15. +10 −0 addon-test-support/@ember/test-helpers/dom/-is-select-element.ts
  16. +62 −0 addon-test-support/@ember/test-helpers/dom/-logging.ts
  17. +9 −0 addon-test-support/@ember/test-helpers/dom/-target.ts
  18. +23 −14 addon-test-support/@ember/test-helpers/dom/blur.ts
  19. +40 −16 addon-test-support/@ember/test-helpers/dom/click.ts
  20. +35 −16 addon-test-support/@ember/test-helpers/dom/double-click.ts
  21. +51 −32 addon-test-support/@ember/test-helpers/dom/fill-in.ts
  22. +23 −13 addon-test-support/@ember/test-helpers/dom/fire-event.ts
  23. +37 −19 addon-test-support/@ember/test-helpers/dom/focus.ts
  24. +59 −0 addon-test-support/@ember/test-helpers/dom/scroll-to.ts
  25. +89 −0 addon-test-support/@ember/test-helpers/dom/select.ts
  26. +33 −15 addon-test-support/@ember/test-helpers/dom/tap.ts
  27. +33 −15 addon-test-support/@ember/test-helpers/dom/trigger-event.ts
  28. +49 −27 addon-test-support/@ember/test-helpers/dom/trigger-key-event.ts
  29. +66 −32 addon-test-support/@ember/test-helpers/dom/type-in.ts
  30. +6 −0 addon-test-support/@ember/test-helpers/dom/wait-for.ts
  31. +3 −2 addon-test-support/@ember/test-helpers/index.ts
  32. +1 −1 addon-test-support/@ember/test-helpers/settled.ts
  33. +10 −2 addon-test-support/@ember/test-helpers/setup-application-context.ts
  34. +23 −17 addon-test-support/@ember/test-helpers/setup-context.ts
  35. +85 −94 addon-test-support/@ember/test-helpers/setup-rendering-context.ts
  36. +0 −24 addon-test-support/@ember/test-helpers/teardown-application-context.ts
  37. +6 −25 addon-test-support/@ember/test-helpers/teardown-context.ts
  38. +0 −40 addon-test-support/@ember/test-helpers/teardown-rendering-context.ts
  39. +12 −2 addon-test-support/@ember/test-helpers/wait-until.ts
  40. 0 addon-test-support/ember-test-helpers/index.d.ts
  41. +0 −7 addon-test-support/ember-test-helpers/index.js
  42. +0 −97 addon-test-support/ember-test-helpers/legacy-0-6-x/-legacy-overrides.js
  43. +0 −200 addon-test-support/ember-test-helpers/legacy-0-6-x/abstract-test-module.js
  44. +0 −147 addon-test-support/ember-test-helpers/legacy-0-6-x/build-registry.js
  45. +0 −35 addon-test-support/ember-test-helpers/legacy-0-6-x/ext/rsvp.js
  46. +0 −30 addon-test-support/ember-test-helpers/legacy-0-6-x/test-module-for-acceptance.js
  47. +0 −364 addon-test-support/ember-test-helpers/legacy-0-6-x/test-module-for-component.js
  48. +0 −58 addon-test-support/ember-test-helpers/legacy-0-6-x/test-module-for-model.js
  49. +0 −296 addon-test-support/ember-test-helpers/legacy-0-6-x/test-module.js
  50. +0 −51 addon-test-support/ember-test-helpers/wait.js
  51. +79 −151 config/ember-try.js
  52. +1 −1 config/environment.js
  53. +0 −2 documentation.yml
  54. +1 −13 ember-cli-build.js
  55. +1 −14 index.js
  56. +47 −44 package.json
  57. +1 −0 testem.js
  58. +1 −1 tests/dummy/app/router.js
  59. +1 −1 tests/dummy/config/environment.js
  60. +3 −1 tests/dummy/config/optional-features.json
  61. +1 −1 tests/helpers/has-jquery.js
  62. +2 −2 tests/helpers/manual-test-waiter.js
  63. +1 −1 tests/helpers/module-for-acceptance.js
  64. +3 −3 tests/index.html
  65. +148 −0 tests/integration/dom/scroll-to-test.js
  66. +0 −75 tests/integration/module-for-acceptance-interop-test.js
  67. +13 −15 tests/integration/settled-test.js
  68. +7 −9 tests/integration/setup-rendering-context-test.js
  69. +8 −20 tests/test-helper.js
  70. +5 −5 tests/unit/application-test.js
  71. +36 −11 tests/unit/dom/blur-test.js
  72. +61 −29 tests/unit/dom/click-test.js
  73. +78 −27 tests/unit/dom/double-click-test.js
  74. +111 −17 tests/unit/dom/fill-in-test.js
  75. +7 −7 tests/unit/dom/find-all-test.js
  76. +8 −7 tests/unit/dom/find-test.js
  77. +90 −14 tests/unit/dom/focus-test.js
  78. +8 −8 tests/unit/dom/get-root-element-test.js
  79. +86 −0 tests/unit/dom/helper-hooks-test.js
  80. +95 −0 tests/unit/dom/logging-test.js
  81. +17 −17 tests/unit/dom/select-files-test.js
  82. +234 −0 tests/unit/dom/select-test.js
  83. +49 −18 tests/unit/dom/tap-test.js
  84. +49 −14 tests/unit/dom/trigger-event-test.js
  85. +54 −19 tests/unit/dom/trigger-key-event-test.js
  86. +123 −17 tests/unit/dom/type-in-test.js
  87. +12 −9 tests/unit/dom/wait-for-test.js
  88. +0 −85 tests/unit/legacy-0-6-x/test-module-for-acceptance-test.js
  89. +0 −862 tests/unit/legacy-0-6-x/test-module-for-component-test.js
  90. +0 −207 tests/unit/legacy-0-6-x/test-module-for-model-test.js
  91. +0 −416 tests/unit/legacy-0-6-x/test-module-test.js
  92. +26 −26 tests/unit/settled-test.js
  93. +38 −17 tests/unit/setup-application-context-test.js
  94. +37 −37 tests/unit/setup-context-test.js
  95. +5 −5 tests/unit/setup-ember-onerror-test.js
  96. +96 −48 tests/unit/setup-rendering-context-test.js
  97. +30 −9 tests/unit/teardown-context-test.js
  98. +0 −77 tests/unit/teardown-rendering-context-test.js
  99. +25 −19 tests/unit/test-debug-info-test.js
  100. +5 −5 tests/unit/test-metadata-test.js
  101. +20 −20 tests/unit/validate-error-handler-test.js
  102. +0 −12 tests/unit/wait-test.js
  103. +21 −5 tests/unit/wait-until-test.js
  104. +2 −1 tsconfig.json
  105. +0 −3 types/ember-test-helpers/legacy-0-6-x/build-registry.d.ts
  106. +2 −0 types/require.d.ts
  107. +4,932 −5,093 yarn.lock
8 changes: 4 additions & 4 deletions .eslintrc.js
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
module.exports = {
root: true,
extends: ['eslint:recommended', 'prettier'],
parser: 'typescript-eslint-parser',
plugins: ['prettier', 'typescript'],
parser: '@typescript-eslint/parser',
plugins: ['prettier', '@typescript-eslint'],
parserOptions: {
ecmaVersion: 2017,
sourceType: 'module',
@@ -18,7 +18,7 @@ module.exports = {
files: ['.eslintrc.js', '.prettierrc.js', 'index.js', 'config/ember-try.js', 'scripts/**'],
excludedFiles: ['addon-test-support/**', 'tests/**'],
parserOptions: {
ecmaVersion: 2015,
ecmaVersion: 2017,
sourceType: 'script',
},
env: {
@@ -47,7 +47,7 @@ module.exports = {
},
},
{
files: ['index.js', 'addon-test-support/**/*.[jt]s', 'config/**/*.js'],
files: ['addon-test-support/**/*.[jt]s'],
plugins: ['disable-features'],
rules: {
'disable-features/disable-async-await': 'error',
67 changes: 67 additions & 0 deletions .github/workflows/ci-build.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
name: CI Build

on:
push:
branches:
- master
- 'v*'
pull_request:
schedule:
- cron: '0 3 * * *' # daily, at 3am

jobs:
test:
name: Tests
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v2
- uses: volta-cli/action@v1
with:
node-version: 10.x
- run: yarn install --frozen-lockfile
- run: yarn lint
- run: yarn test

floating-dependencies:
name: "Floating Dependencies"
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v2
- uses: volta-cli/action@v1
with:
node-version: 10.x
- run: yarn install --no-lockfile
- run: yarn test

try-scenarios:
name: "Try: ${{ matrix.ember-try-scenario }}"

runs-on: ubuntu-latest

needs: test

strategy:
fail-fast: true
matrix:
ember-try-scenario:
- ember-lts-3.8
- ember-lts-3.12
- ember-lts-3.16
- ember-lts-3.20
- ember-release
- ember-beta
- ember-canary
- ember-classic
- ember-default-with-jquery

steps:
- uses: actions/checkout@v2
- uses: volta-cli/action@v1
with:
node-version: 12.x
- name: install dependencies
run: yarn install --frozen-lockfile
- name: test
run: node_modules/.bin/ember try:one ${{ matrix.ember-try-scenario }} --skip-cleanup
1 change: 1 addition & 0 deletions .prettierrc.js
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
module.exports = {
arrowParens: 'avoid',
singleQuote: true,
trailingComma: 'es5',
printWidth: 100,
85 changes: 0 additions & 85 deletions .travis.yml

This file was deleted.

22 changes: 21 additions & 1 deletion API.md
Original file line number Diff line number Diff line change
@@ -371,7 +371,7 @@ Emulating pressing the `ENTER` key on a button using `triggerKeyEvent`
triggerKeyEvent('button', 'keydown', 'Enter');
```

Returns **[Promise][54]&lt;void>** resolves when the application is settled
Returns **[Promise][54]&lt;void>** resolves when the application is settled unless awaitSettled is false

### typeIn

@@ -501,6 +501,15 @@ interim DOM states (e.g. loading states, pending promises, etc).
- `options.timeout` **[number][62]** the time to wait (in ms) for a match (optional, default `1000`)
- `options.count` **[number][62]** the number of elements that should match the provided selector (null means one or more) (optional, default `null`)

#### Examples

Waiting until a selector is rendered:


```javascript
await waitFor('.my-selector', { timeout: 2000 })
```

Returns **[Promise][54]&lt;([Element][53] \| [Array][64]&lt;[Element][53]>)>** resolves when the element(s) appear on the page

### waitUntil
@@ -517,6 +526,17 @@ while _not_ settled (e.g. "loading" or "pending" states).
- `options.timeout` **[number][62]** the maximum amount of time to wait (optional, default `1000`)
- `options.timeoutMessage` **[string][52]** the message to use in the reject on timeout (optional, default `'waitUntil timed out'`)

#### Examples

Waiting until a selected element displays text:


```javascript
await waitUntil(function() {
return find('.my-selector').textContent.includes('something')
}, { timeout: 2000 })
```

Returns **[Promise][54]** resolves with the callback value when it returns a truthy value

### settled
Loading