{"id":21046358,"url":"https://github.com/kitschpatrol/es-check-min","last_synced_at":"2026-02-27T17:44:37.687Z","repository":{"id":243434565,"uuid":"812414950","full_name":"kitschpatrol/es-check-min","owner":"kitschpatrol","description":"A CLI tool and library to find the minimum compatible ECMAScript version of a JavaScript file.","archived":false,"fork":false,"pushed_at":"2025-11-05T01:51:22.000Z","size":1023,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-05T03:22:05.889Z","etag":null,"topics":["cli","ecmascript","es-check","npm-package","version-detection"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kitschpatrol.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-08T20:32:09.000Z","updated_at":"2025-11-05T01:51:25.000Z","dependencies_parsed_at":"2024-06-08T21:43:07.225Z","dependency_job_id":"eabc248f-6c82-47fb-b7ea-69e75bfc7888","html_url":"https://github.com/kitschpatrol/es-check-min","commit_stats":null,"previous_names":["kitschpatrol/es-check-min"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/kitschpatrol/es-check-min","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitschpatrol%2Fes-check-min","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitschpatrol%2Fes-check-min/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitschpatrol%2Fes-check-min/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitschpatrol%2Fes-check-min/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kitschpatrol","download_url":"https://codeload.github.com/kitschpatrol/es-check-min/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kitschpatrol%2Fes-check-min/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29906773,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T17:28:36.873Z","status":"ssl_error","status_checked_at":"2026-02-27T17:28:20.970Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","ecmascript","es-check","npm-package","version-detection"],"created_at":"2024-11-19T14:29:15.982Z","updated_at":"2026-02-27T17:44:37.680Z","avatar_url":"https://github.com/kitschpatrol.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--+ Warning: Content inside HTML comment blocks was generated by mdat and may be overwritten. +--\u003e\n\n\u003c!-- title --\u003e\n\n# es-check-min\n\n\u003c!-- /title --\u003e\n\n\u003c!-- badges --\u003e\n\n[![NPM Package es-check-min](https://img.shields.io/npm/v/es-check-min.svg)](https://npmjs.com/package/es-check-min)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003c!-- /badges --\u003e\n\n\u003c!-- short-description --\u003e\n\n**A CLI tool and library to find the minimum compatible ECMAScript version of a JavaScript file.**\n\n\u003c!-- /short-description --\u003e\n\n## Overview\n\nA simple tool built on [`es-check`](https://github.com/yowainwright/es-check) to find the lowest supported [ECMAScript version](https://en.wikipedia.org/wiki/ECMAScript_version_history) of a JavaScript file.\n\nThe `es-check-min` tool does not require any arguments, and simply runs a loop to determine the file's lowest compatible ECMAScript version. This is in slight contrast to `es-check` which checks a file against a _specified_ ECMAScript version.\n\nDetection of the following ECMAScript versions is supported:\n\n- ES5\n- ES6 / ES2015\n- ES7 / ES2016\n- ES8 / ES2017\n- ES9 / ES2018\n- ES10 / ES2019\n- ES11 / ES2020\n- ES12 / ES2021\n- ES13 / ES2022\n\n_Note: The underlying `es-check` implementation technically supports ES3 and ES14 / ES2023, but certain tests aren't passing against these targets so they are not currently returned._\n\n## Getting started\n\n### Dependencies\n\nThe `es-check-min` CLI tool requires Node 20+. The exported APIs are ESM and share the Node 20+ requirement.\n\n### Installation\n\nInvoke directly:\n\n```sh\nnpx es-check-min\n```\n\nOr, install locally to access the CLI commands in a single project or to import the provided APIs:\n\n```sh\nnpm install es-check-min\n```\n\nOr, install globally for access across your system:\n\n```sh\nnpm install --global es-check-min\n```\n\n## Usage\n\n### CLI\n\n#### Example\n\n```sh\nes-check-min ./mystery-file.js\n```\n\nprints...\n\n```sh\nes6/es2015\n```\n\n\u003c!-- cli-help --\u003e\n\n#### Command: `es-check-min`\n\nGet the minimum supported ECMAScript version of a JavaScript file.\n\nUsage:\n\n```txt\nes-check-min \u003cfile\u003e\n```\n\n| Positional Argument | Description                           | Type     |\n| ------------------- | ------------------------------------- | -------- |\n| `file`              | Path to the JavaScript file to check. | `string` |\n\n| Option              | Description         | Type      |\n| ------------------- | ------------------- | --------- |\n| `--help`\u003cbr\u003e`-h`    | Show help           | `boolean` |\n| `--version`\u003cbr\u003e`-v` | Show version number | `boolean` |\n\n\u003c!-- /cli-help --\u003e\n\n### Library\n\nA single function is exported:\n\n```ts\nfunction esCheckMin(path: string): Promise\u003cEsVersion | undefined\u003e\n```\n\n## Background\n\nRequests for something like this have come up once or twice:\n\n- [Make babel tell me the minimum version of target that supports my code](https://github.com/babel/babel/issues/8008)\n- [Feature Request: Wrapper command for \"minimum ES version\" for a file](https://github.com/dollarshaveclub/es-check/issues/101)\n\n## Maintainers\n\n[@kitschpatrol](https://github.com/kitschpatrol)\n\n## Acknowledgments\n\n`es-check-min` is just a trivial wrapper over `es-check`. All credit goes to [Jeff Wainwright](https://github.com/yowainwright) and [contributors](https://github.com/yowainwright/es-check?tab=readme-ov-file#contributors) for creating and maintaining [`es-check`](https://github.com/yowainwright/es-check).\n\n\u003c!-- contributing --\u003e\n\n## Contributing\n\n[Issues](https://github.com/kitschpatrol/es-check-min/issues) and pull requests are welcome.\n\n\u003c!-- /contributing --\u003e\n\n\u003c!-- license --\u003e\n\n## License\n\n[MIT](license.txt) © Eric Mika\n\n\u003c!-- /license --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitschpatrol%2Fes-check-min","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkitschpatrol%2Fes-check-min","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkitschpatrol%2Fes-check-min/lists"}