angular-cn/integration/language_service_plugin/README.md

# Angular Language Service Test

This directory is an integration test for `@angular/language-service` to ensure
that the language service works correctly as a `tsserver` plugin.

To use the tests:

- Use `yarn install` to install all dependencies in this directory and in the Angular repo root
    directory.
- Build an Angular distribution with `yarn build-dist`. This needs to be done after changes to
    Angular, but not after changes to integration tests. This is an expensive build.
- In this directory, run the integration tests with `yarn test`.

## Update golden files

If the expected output needs to be updated, run `yarn golden my-golden.json`, replacing
`my-golden.json` with the golden file to be updated. Do not qualify the file with a directory path.
See [generate.ts](./generate.ts) for more information.

## Adding a new fixture

Currently there is no automated way to produce a new fixture. The way the
current fixtures were created was to hack a version of tsserver.js to write the
commands from `VSCode` to a file while performing the operation to be tested.
I also hand modified the input to remove superfluous request.

Once a new fixture is created:

1) Add the fixture name to `goldens/`
2) Run `yarn golden my-golden.json`, replacing `my-golden.json` with the new fixture name, to
   produce the expected output files.
3) Hand validate that the expected output is reasonable.