ESPARSE(1)

💖 ESPARSE(1) 💖

okay bestie, welcome to esparse — the ECMAScript Parser using Esprima ✨ it's giving "I read your JavaScript and I have opinions" and honestly? iconic.

🌸 NAME 🌸

esparse — ECMAScript Parser using Esprima 🦋

like. she parses. she's an ECMAScript parser. she uses Esprima. that's the whole vibe, no notes 💅

✨ DESCRIPTION ✨

🎀 Usage:

esparse [options] file.js

so you hand her a file.js and a pile of [options], and she does her little parser thing. simple. gorgeous. main character energy fr fr 😌

👑 Available options:

• --comment — gathers all line and block comments into an array 💬 like, every comment you left in there (yes, even the // TODO: fix this one from 2019) gets scooped up together.
• --loc — includes line-column location info for each syntax node 📍 so you know exactly where in the file every node is chilling. very "I know where you live" of her.
• --range — includes an index-based range for each syntax node 🔢 character offsets, bestie, not line numbers. different flavor of knowing where things are.
• --raw — displays the raw value of literals 🍓 the literal, as written, untouched. no glow-up, no interpretation.
• --tokens — lists all tokens in an array 🔥 the whole token stream, laid out flat. it's giving receipts.
• --tolerant — tolerates errors on a best-effort basis 🫶 it's experimental, so like… she'll try her best, but no promises, okay? don't come for her.
• -v, --version — shows program version 👑 the classic. the little "who am I" check-in.

ngl, if you're leaning on --tolerant, just know it's flagged experimental in the source — so it's a vibe, not a guarantee. don't be shocked if things get messy 😭

🦋 that's the whole page, bestie 🦋

this gorgeous little manual is from the ECMAScript Parser crew, dated June 2016 — and it lives in the User Commands section of the manual as ESPARSE(1). slay, parse, periodt 💅✨🎀