Repository navigation
Test(Integration): migrate test/integration into @wordpress/integration-tests workspace
#77556
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,58 @@ | ||
| # Integration Tests | ||
|
|
||
| This directory contains the integration test suite for the Gutenberg project, published as the `@wordpress/integration-tests` workspace package. | ||
|
|
||
|
|
||
| ## What Are Integration Tests? | ||
|
|
||
| Unlike unit tests that test individual functions in isolation, these tests exercise multiple packages working together. They cover: | ||
|
|
||
| | Test file | What it tests | | ||
| |---|---| | ||
| | `blocks-schema.test.js` | Validates all `block.json` files in the repo against the JSON schema | | ||
| | `theme-schema.test.js` | Validates all `theme.json` files in the repo against the JSON schema | | ||
| | `wp-env-schema.test.js` | Validates `.wp-env.json` against the JSON schema | | ||
| | `blocks-raw-handling.test.js` | Tests raw paste/HTML handling across the full block pipeline | | ||
| | `full-content/full-content.test.js` | Tests full block serialization round-trips using fixtures | | ||
| | `is-valid-block.test.js` | Tests block validation with editor hooks applied | | ||
| | `shortcode-converter.test.js` | Tests shortcode-to-block conversion | | ||
| | `non-matched-tags-handling.test.js` | Tests handling of unrecognized HTML tags during paste | | ||
|
|
||
| ## Running the Tests | ||
|
|
||
| Integration tests run as part of the standard unit test command: | ||
|
|
||
| ```bash | ||
| npm run test:unit | ||
| ``` | ||
|
|
||
| To run only the integration tests: | ||
|
|
||
| ```bash | ||
| npm run test:unit -- test/integration | ||
| ``` | ||
|
|
||
| To run a specific integration test file: | ||
|
|
||
| ```bash | ||
| npm run test:unit -- test/integration/blocks-schema.test.js | ||
| ``` | ||
|
|
||
| ## Fixtures | ||
|
|
||
| The `fixtures/blocks/` directory contains serialized block fixtures used by `full-content.test.js` to verify that blocks serialize and parse correctly. | ||
|
|
||
| To generate missing fixtures: | ||
|
|
||
| ```bash | ||
| npm run fixtures:generate | ||
| ``` | ||
|
|
||
| To regenerate all fixtures from scratch: | ||
|
|
||
| ```bash | ||
| npm run fixtures:regenerate | ||
| ``` | ||
|
|
||
| ## Jest Configuration | ||
|
|
||
| These tests reuse the Jest configuration from `test/unit/jest.config.js`. There is no separate Jest config in this directory — `test/unit`'s config sets `rootDir` to the repo root, which automatically discovers tests in this directory. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,39 @@ | ||||||||||||||||||||
| { | ||||||||||||||||||||
| "name": "@wordpress/integration-tests", | ||||||||||||||||||||
| "version": "0.0.0", | ||||||||||||||||||||
| "description": "Integration tests for WordPress Gutenberg.", | ||||||||||||||||||||
| "private": true, | ||||||||||||||||||||
| "author": "The WordPress Contributors", | ||||||||||||||||||||
| "license": "GPL-2.0-or-later", | ||||||||||||||||||||
| "keywords": [ | ||||||||||||||||||||
| "wordpress", | ||||||||||||||||||||
| "gutenberg", | ||||||||||||||||||||
| "integration-tests" | ||||||||||||||||||||
| ], | ||||||||||||||||||||
| "homepage": "https://github.com/WordPress/gutenberg/tree/HEAD/test/integration/README.md", | ||||||||||||||||||||
|
Member
There was a problem hiding this comment. This file doesn't exist. Let us create one. There was a problem hiding this comment. The
Suggested change
|
||||||||||||||||||||
| "repository": { | ||||||||||||||||||||
| "type": "git", | ||||||||||||||||||||
| "url": "git+https://github.com/WordPress/gutenberg.git", | ||||||||||||||||||||
| "directory": "test/integration" | ||||||||||||||||||||
| }, | ||||||||||||||||||||
| "bugs": { | ||||||||||||||||||||
| "url": "https://github.com/WordPress/gutenberg/issues" | ||||||||||||||||||||
| }, | ||||||||||||||||||||
| "devDependencies": { | ||||||||||||||||||||
|
Comment on lines
+21
to
+22
There was a problem hiding this comment. Other test workspaces define workspace-scoped scripts and include the runner dependency they use (e.g.
Suggested change
|
||||||||||||||||||||
| "@testing-library/react": "^16.3.2", | ||||||||||||||||||||
| "@testing-library/user-event": "^14.6.1", | ||||||||||||||||||||
| "@wordpress/block-editor": "file:../../packages/block-editor", | ||||||||||||||||||||
| "@wordpress/block-library": "file:../../packages/block-library", | ||||||||||||||||||||
| "@wordpress/block-serialization-default-parser": "file:../../packages/block-serialization-default-parser", | ||||||||||||||||||||
| "@wordpress/blocks": "file:../../packages/blocks", | ||||||||||||||||||||
| "@wordpress/data": "file:../../packages/data", | ||||||||||||||||||||
| "@wordpress/element": "file:../../packages/element", | ||||||||||||||||||||
| "@wordpress/prettier-config": "file:../../packages/prettier-config", | ||||||||||||||||||||
| "@wordpress/rich-text": "file:../../packages/rich-text", | ||||||||||||||||||||
| "ajv": "^8.17.1", | ||||||||||||||||||||
| "fast-glob": "^3.2.7" | ||||||||||||||||||||
| }, | ||||||||||||||||||||
|
Comment on lines
+22
to
+35
Member
There was a problem hiding this comment. Let us ensure that we declare all the dependencies that the workspace uses.
Member
There was a problem hiding this comment. Also, |
||||||||||||||||||||
| "publishConfig": { | ||||||||||||||||||||
| "access": "public" | ||||||||||||||||||||
| } | ||||||||||||||||||||
| } | ||||||||||||||||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
PR description mentions adding
test:integration/watch/debug scripts and atest/integration/jest.config.js, but those changes aren’t present (root scripts still only include unit-test runners, andtest/integration/has no jest config). Either update the PR description or include the missing script/config changes so the workspace can actually be executed independently as described.