TypeScript compiler (tsc), but errors have absolute paths
npm install tsc-absoluteš TypeScript compiler (tsc), but errors have absolute paths.
Inspired by this 2016 TypeScript issue, and a similar one opened in 2020. Given it seems to be a feature many people want, but the TypeScript team seem to be avoiding, this acts as a simple wrapper that implements this feature.
This is particularly useful for navigating to errors in monorepo setups, or for automating error detection and location from logs.
``sh`
npm install --save-dev typescript tsc-absolute
Just use it as a drop-in replacement for tsc wherever you use it. All arguments are passed right through. For example:
`diff title="package.json"`
"scripts": {
- "build": "tsc --strict"
+ "build": "tsc-absolute --strict"
}
This turns your logs from relative paths:
`
src/some/path/code.ts(20,9): error TS2322: Type 'number' is not assignable to type 'string'.
to absolute ones:
`
/home/domdomegg/my-workspace/my-package/src/some/path/code.ts(20,9): error TS2322: Type 'number' is not assignable to type 'string'.
It supports any version of TypeScript released in the last 12 months, mirroring the TypeScript team's security support window. This is validated with intregration tests that run in CI.
The library accepts TypeScript as a peer dependency, so just install TypeScript like normal to your preferred version and tsc-absolute will use that one.
It may work with older versions, but this is not explicitly supported. You should probably update anyways to ensure you continue to recieve security updates.
With this configuration, you can set up a GitHub problem matcher, for example in .github/matchers/tsc-absolute.json:
`json`
{
"problemMatcher": [
{
"owner": "tsc-absolute",
"pattern": [
{
"regexp": "(?:^|\\s)([^\\s][^:])\\(:,:(?:\\):\\s+|\\s+-\\s+)(error|warning|info)\\s+(TS\\d+)\\s:\\s(.)$",
"file": 1,
"line": 2,
"column": 3,
"severity": 4,
"code": 5,
"message": 6
}
]
}
]
}
And in your workflow.yaml, add a step:
`yaml`
- name: Configure TSC problem matcher
run: |
echo "::remove-matcher owner=tsc::"
echo "::add-matcher::.github/matchers/tsc-absolute.json"
As an example, when you're done you can get output like this on your commits and PRs: https://github.com/domdomegg/tsc-absolute-github-actions-example/commit/cf254dc82fac7099070fbaa3cd78f83989c70d5a#diff-a2a171449d862fe29692ce031981047d7ab755ae7f84c707aef80701b3ea0c80
This is a best-efforts approach at correcting the error output and is usually very accurate. However, as the TypeScript compiler does not provide structured logging nor is it part of their public interface, it may break if TypeScript's logging format changes.
Additionally, the way the logs are (un)structured the regex can make mistakes if you have extremely odd filenames. The filenames have to be to the point that you'd probably have to be trying to break this, i.e. ones that have both spaces and brackets with numbers at just the wrong places in them - but if you're accepting any kind of input it's one to be aware of.
Pull requests are welcomed on GitHub! To get started:
1. Install Git and Node.js
2. Clone the repository
3. Install dependencies with npm install
4. Run to run testsnpm run build
5. Build with
Versions follow the semantic versioning spec.
To release:
1. Use npm version to bump the versiongit push --follow-tags` to push with tags
2. Run
3. Wait for GitHub Actions to publish to the NPM registry.