Boshen 9b3165f524 docs(napi/parser): clarify when to use parseAsync vs parseSync (#18486) ...

## Summary

- Add detailed JSDoc documentation to `parse` and `parseSync` functions explaining their performance characteristics
- Clarify that `parseSync` is generally preferable since AST deserialization happens on the main thread anyway
- Recommend using worker threads with `parseSync` for parallelizing multiple files

Closes #15361

🤖 Generated with [Claude Code](https://claude.ai/code)

2026-01-24 14:54:52 +00:00

8.1 KiB

Raw Permalink Blame History

View Raw