Well, Does it Throw?
TLDR; This is a blazingly fast lsp server to find throw statements in your javascript code. It's written in Rust and based on SWC 🔥. It works for most ECMAScript files, such as .ts, .js, .tsx and .jsx.
Check it out in action:
Also supports call expressions:
Why?
Maybe you're working on a large codebase riddled with throw statements everywhere, and you want a better control flow. Or perhaps you're just curious about how many throw statements you have in your codebase. This simple tool can help you with that.
Untyped throw statements can be a pain for those who come from languages like Go, where errors are typically values and first class citizens. Even Rust has the Result type. Knowing where throw statements are in your codebase might be helpful, even if their return types aren't directly supported.
This extension may not be for everyone, but it's definitely for me. I hope you find it useful too.
Installation
| Platform | Installation |
|---|---|
| VsCode | via Marketplace |
| NeoVim | Coming soon... |
This extension is built with security in mind. It doesn't send any data to any third party servers. All publishes are done via a signed immutable commit from the CI pipeline.
The core of the code is written in Rust, and the LSP implementation for VsCode is written in Typescript. The Rust code is compiled to WASM and bundled with the VsCode extension. The extension is published to the VsCode marketplace, and the Rust code is published to crates.io.
Limitations
- This extension is still in its early stages. It's not perfect, but hope to gain sufficient ECMAScript coverage over time.
- Currently, it only supports ECMAScript files and the following file types:
.ts,.js,.tsxand.jsx. - Call expression tracing (Aka "Calls to Throws") is now set to one level deep. Hope to make this configurable in the future!
To view all known limitations, please see the issues page.
Contributing
Contributions are certainly welcome! Please open an issue or submit a PR. If you find a use case that isn't supported yet, please search the open issues and open a new one if it doesn't exist.
Dev Setup
Everything can be found in the CONTRIBUTING.md file!
Feedback & Suggestions
Please use the GitHub discussions tab to provide feedback and suggestions. Thanks!
Acknowledgements
- SWC - The blazing fast javascript compiler written in Rust.
- Oso Vscode Extension - For the WASM inspiration. Excellent article here.
License
MIT - See LICENSE for more information.
3 Dec 15, 2022
4 Mar 19, 2023
13 Oct 3, 2023
4 Aug 14, 2022
16 Aug 17, 2022
12 May 5, 2022
2 Sep 8, 2022
2 Apr 25, 2022
113 Dec 28, 2022
344 Dec 31, 2022
5 Oct 15, 2022
12 Dec 2, 2022
17 Dec 18, 2022
87 Dec 10, 2022
2 Oct 23, 2022
2 Oct 27, 2022
3 Nov 25, 2022
23 Jan 3, 2023
78 Jan 3, 2023