swagger-api / swagger-js
Javascript library to connect to swagger-enabled APIs via browser or nodejs
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing swagger-api/swagger-js in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewSwagger Client **Swagger Client** is a JavaScript module that allows you to fetch, resolve, and interact with Swagger/OpenAPI documents. New! **This is the new version of swagger-js, 3.x.** The new version supports Swagger 2.0 as well as OpenAPI 3. Want to learn more? Check out our FAQ. For features known to be missing from 3.x please see the Graveyard. For the older version of swagger-js, refer to the *2.x branch*. > *The npm package is called and the GitHub repository is . We'll be consolidating that soon. Just giving you the heads-up. You may see references to both names.* Compatibility The OpenAPI Specification has undergone multiple revisions since initial creation in 2010. Compatibility between Swagger Client and the OpenAPI Specification is as follows: Swagger Client Version | Release Date | OpenAPI Spec compatibility | Notes ------------------ |--------------|---------------------------------------------------------| ----- 3.37.x | 2026-02-27 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3, 3.0.4, 3.1.0, 3.2.0 | tag v3.37.0 3.33.x | 2024-12-30 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3, 3.0.4, 3.1.0 | tag v3.33.0 3.19.x | 2023-01-23 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3, 3.1.0 | tag v3.19.0-alpha.3 3.10.x | 2020-01-17 | 2.0, 3.0.0, 3.0.1, 3.0.2, 3.0.3 | tag v3.10.0 2.1.32 | 2017-01-12 | 1.0, 1.1, 1.2 | tag v2.1.32. This release is only available on GitHub. Anonymized analytics Swagger Client uses Scarf to collect anonymized installation analytics. These analytics help support the maintainers of this library and ONLY run during installation. To opt out, you can set the field to in your project's : Alternatively, you can set the environment variable to as part of the environment that installs your npm packages, e.g., . Documentation Usage • Installation • Tags Interface • HTTP client for OAS operations • OpenAPI Definition Resolver • HTTP Client • Swagger Client API Development • Contributing • Setting up • Scripts Migrations • Migration guide • Graveyard Runtime Node.js requires Node.js and uses different implementation depending on Node.js version. • - node-fetch@3 • - native Node.js fetch > NOTE: swagger-client minimum Node.js runtime version aligns with Node.js Releases > which means that we can drop support for **EOL** (End Of Life) Node.js versions without doing major version bump. Browsers works in the latest versions of Chrome, Safari, Firefox, and Edge and uses native fetch implementation provided by each supported browser. Security contact Please disclose any security-related issues or vulnerabilities by emailing security@swagger.io, instead of using the public issue tracker.