{"id":28288487,"url":"https://github.com/sandeepv68/reaxios","last_synced_at":"2026-02-14T12:33:38.115Z","repository":{"id":32871726,"uuid":"144587505","full_name":"Sandeepv68/reaxios","owner":"Sandeepv68","description":"reAxios - axios wrapped in reactive extension. reAxios is an observables wrapper for promise based Axios ajax library","archived":false,"fork":false,"pushed_at":"2022-12-07T22:48:09.000Z","size":1332,"stargazers_count":4,"open_issues_count":19,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-15T21:38:27.021Z","etag":null,"topics":["ajax","axios","javascript","nodejs","observables","reactive","reactive-extensions","reactive-programming","reaxios","rxjs","umd-modules","wrapper"],"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/Sandeepv68.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-13T14:00:08.000Z","updated_at":"2021-10-18T05:05:38.000Z","dependencies_parsed_at":"2023-01-14T22:29:50.061Z","dependency_job_id":null,"html_url":"https://github.com/Sandeepv68/reaxios","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Sandeepv68/reaxios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sandeepv68%2Freaxios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sandeepv68%2Freaxios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sandeepv68%2Freaxios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sandeepv68%2Freaxios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sandeepv68","download_url":"https://codeload.github.com/Sandeepv68/reaxios/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sandeepv68%2Freaxios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29443475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T10:51:12.367Z","status":"ssl_error","status_checked_at":"2026-02-14T10:50:52.088Z","response_time":53,"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":["ajax","axios","javascript","nodejs","observables","reactive","reactive-extensions","reactive-programming","reaxios","rxjs","umd-modules","wrapper"],"created_at":"2025-05-22T00:12:02.807Z","updated_at":"2026-02-14T12:33:38.099Z","avatar_url":"https://github.com/Sandeepv68.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](public/reAxios.png)\n# reAxios v0.0.3\n\n[![GitHub license](https://img.shields.io/github/license/SandeepVattapparambil/reaxios.svg?style=flat-square)](https://github.com/SandeepVattapparambil/reaxios/blob/master/LICENSE) ![travisci](https://api.travis-ci.org/SandeepVattapparambil/reaxios.svg?branch=master) [![CircleCI](https://circleci.com/gh/SandeepVattapparambil/reaxios.svg?style=svg)](https://circleci.com/gh/SandeepVattapparambil/reaxios) [![Known Vulnerabilities](https://snyk.io/test/github/SandeepVattapparambil/reaxios/badge.svg?targetFile=package.json)](https://snyk.io/test/github/SandeepVattapparambil/reaxios?targetFile=package.json) [![CodeFactor](https://www.codefactor.io/repository/github/sandeepvattapparambil/reaxios/badge/master)](https://www.codefactor.io/repository/github/sandeepvattapparambil/reaxios/overview/master) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a6988d53e74246649974096fcdbe55bb)](https://www.codacy.com/project/sandeepv68/reaxios/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=SandeepVattapparambil/reaxios\u0026amp;utm_campaign=Badge_Grade_Dashboard) [![codecov](https://codecov.io/gh/SandeepVattapparambil/reaxios/branch/master/graph/badge.svg)](https://codecov.io/gh/SandeepVattapparambil/reaxios) [![GitHub issues](https://img.shields.io/github/issues/SandeepVattapparambil/reaxios.svg?style=flat-square)](https://github.com/SandeepVattapparambil/reaxios/issues) [![GitHub forks](https://img.shields.io/github/forks/SandeepVattapparambil/reaxios.svg?style=flat-square)](https://github.com/SandeepVattapparambil/reaxios/network) [![GitHub stars](https://img.shields.io/github/stars/SandeepVattapparambil/reaxios.svg?style=flat-square)](https://github.com/SandeepVattapparambil/reaxios/stargazers) [![Twitter](https://img.shields.io/twitter/url/https/github.com/SandeepVattapparambil/reaxios.svg?style=flat-square)](https://twitter.com/intent/tweet?text=Wow:\u0026url=https%3A%2F%2Fgithub.com%2FSandeepVattapparambil%2Freaxios)\n\n\nA simple reactive **observable** wrapper for the popular [Axios](https://www.npmjs.com/package/axios) library. Axios is a **Promise** based HTTP client for the browser and node.js. reAxios wraps axios inside an RxJs observable and exposes it. All the axios features and options are supported through reAxios.\n\n### Why RxJs and Observables ?\n**RxJs** is a JavaScript library to perform **Reactive programming**. RxJs is the JavaScript implementation of **ReactiveX**. ReactiveX is a combination of the best ideas from the Observer pattern, the Iterator pattern, and functional programming. There are many advantages for reactive programming:\n- **Functional** -\nAvoid intricate stateful programs, using clean input/output functions over observable streams.\n\n- **Less is more** -\nReactiveX's operators often reduce what was once an elaborate challenge into a few lines of code.\n\n- **Async error handling** -\nTraditional try/catch is powerless for errors in asynchronous computations, but ReactiveX is equipped with proper mechanisms for handling errors.\n\n- **Concurrency made easy** -\nObservables and Schedulers in ReactiveX allow the programmer to abstract away low-level threading, synchronization, and concurrency issues.\n\n- And the popular kids are doing observables nowadays, its the new **cool**\n\n### Getting started\nFollow these steps to grab a copy of **reAxios** and use it in your project. The `reaxios` package will have two build distributables, a regular build and minified compressed build. By default package managers are set to use the minified version\n\n| **build** | **asset** | **size** |\n| --- | --- | --- |\n| compressed | reAxios.min.js | 2.73KB |\n| uncompressed | reAxios.js | 12KB |\n\n#### Dependency\nThis library is dependent on the following Npm packages:\n- [rxjs](https://www.npmjs.com/package/rxjs)\n- [axios](https://www.npmjs.com/package/axios)\n\n\u003e**Note** Missing dependency will cause errors.\n\n#### Installation\n**reAxios** is a UMD module, which means it can be run across all javascript environments ranging from browsers to servers(node). reAxios can be used on browsers in conjunction with RxJs and axios in node-like browser environments as in ReactJS, AngularJS, VueJS or MarkoJS or it can be used in NodeJS apps.\n\nUsing npm\n```sh\nnpm i --save reaxios\n```\n\nUsing yarn\n```sh\nyarn add reaxios\n```\n\n#### Usage\n```js\n//In your Node.js app\nconst ReAxios = require('reaxios');\n\n//Or using ES6 - ES7 import statement\nimport reAxios from 'reaxios';\n\n//ReAxios can take all the axios configuration parameters here\nconst reAxios = new ReAxios({\n  baseURL: 'https://jsonplaceholder.typicode.com/todos/1',\n});\n\n//GET request\nreAxios.get('/').subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n**Output**\n```js\n{\n  \"userId\": 1,\n  \"id\": 1,\n  \"title\": \"delectus aut autem\",\n  \"completed\": false\n}\n```\n#### Changelog\n- **v0.0.3**\n  - UMD Tweaks\n  - Documentation updates\n\n- **v0.0.2** - **v0.0.1**\n  - es6 code base\n  - UMD build, can be used on browser and server side\n  - 100% code coverage\n  - Tests using jest\n  - Vulnerabilities check added\n  - Travis CI added\n  - Circle CI added\n\n#### API Documentation\nVarious apis provided by reAxios are documented here.\n\n##### reAxios.get()\nThe default HTTP GET method of Axios wrapped in an observable.\n```js\nreAxios.get(url, queryParams)\n```\n##### Paraneters\n| **Parameter** | **Type** | **Description** |\n| -- | -- | -- |\n| **url** | *String* | The url to be fetched |\n| **queryParams** | *Object* | The query parameters to be passed along with the url |\n\nexample:\n```js\nreAxios.get(url, queryParams).subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n\n##### reAxios.post()\nThe default HTTP POST method of Axios wrapped in an observable.\n```js\nreAxios.post(url, body, queryParams)\n```\n##### Parameters\n| **Parameter** | **Type** | **Description** |\n| -- | -- | -- |\n| **url** | *String* | The url to be fetched |\n| **body** | *Object* | The request body |\n| **queryParams** | *Object* | The query parameters to be passed along with the url |\n\nexample:\n```js\nreAxios.post(url, body, queryParams).subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n\n##### reAxios.put()\nThe default HTTP PUT method of Axios wrapped in an observable.\n```js\nreAxios.put(url, body, queryParams)\n```\n##### Parameters\n| **Parameter** | **Type** | **Description** |\n| -- | -- | -- |\n| **url** | *String* | The url to be fetched |\n| **body** | *Object* | The request body |\n| **queryParams** | *Object* | The query parameters to be passed along with the url |\n\nexample:\n```js\nreAxios.put(url, body, queryParams).subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n\n##### reAxios.patch()\nThe default HTTP PATCH method of Axios wrapped in an observable.\n```js\nreAxios.patch(url, body, queryParams)\n```\n##### Parameters\n| **Parameter** | **Type** | **Description** |\n| -- | -- | -- |\n| **url** | *String* | The url to be fetched |\n| **body** | *Object* | The request body |\n| **queryParams** | *Object* | The query parameters to be passed along with the url |\n\nexample:\n```js\nreAxios.patch(url, body, queryParams).subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n\n##### reAxios.delete()\nThe default HTTP DELETE method of Axios wrapped in an observable.\n```js\nreAxios.delete(url, queryParams)\n```\n##### Parameters\n| **Parameter** | **Type** | **Description** |\n| -- | -- | -- |\n| **url** | *String* | The url to be fetched |\n| **queryParams** | *Object* | The query parameters to be passed along with the url |\n\nexample:\n```js\nreAxios.delete(url, queryParams).subscribe(\n  response =\u003e {\n    console.log(response.data);\n  },\n  err =\u003e {\n    console.error(err);\n  }\n);\n```\n\n\u003e**Note** All advanced RxJs operations can be performed on the observables returned by reAxios.\n\n#### Continuous Integration (CI)\nContinuous Integration services monitor repositories for changes, then automatically run unit tests on your behalf, typically in a containerized environment. To test this setup works in a continuous integration environment, an integration was done with Travis CI \u0026 CircleCI. According to the Travis Node.js Documentation, Travis automatically runs npm install and npm test. The only additional thing I had to add to the Travis configuration was to run npm run build before running the tests. The working Travis config looks like this:\n```yml\nlanguage: node_js\n\nnode_js:\n  - stable\n  \ninstall:\n  - npm install\n  - npm install -g codecov\n\nscript:\n  - npm run build-dev\n  - npm run build-prod\n  - npm test\n  - jest ./test/reAxios.spec.js \n  - codecov\n```\nCircleCI is similar to Travis-CI, but is more extensible and has much more control over the build process. The CircleCI config looks like this:\n```yml\n# Javascript Node CircleCI 2.0 configuration file\n# Check https://circleci.com/docs/2.0/language-javascript/ for more details\nversion: 2\njobs:\n  build:\n    docker:\n      # specify the version you desire here\n      - image: circleci/node:7.10\n      # Specify service dependencies here if necessary\n      # CircleCI maintains a library of pre-built images\n      # documented at https://circleci.com/docs/2.0/circleci-images/\n      # - image: circleci/mongo:3.4.4\n    working_directory: ~/repo\n    steps:\n      - checkout\n      # Download and cache dependencies\n      - restore_cache:\n          keys:\n          - v1-dependencies-{{ checksum \"package.json\" }}\n          # fallback to using the latest cache if no exact match is found\n          - v1-dependencies-\n      - run: npm install\n      - save_cache:\n          paths:\n            - node_modules\n          key: v1-dependencies-{{ checksum \"package.json\" }}\n      # run tests!\n      - run: npm run build-dev\n      - run: npm run build-prod\n      - run: npm test\n```\n\n#### Tests\nThis library uses Jest framework for unit testing. All unit tests are available in the test folder. Tests can be run by the command:\n```sh\nnpm test\n```\n\n#### Contributing\nPlease read [CONTRIBUTING.md](https://github.com/SandeepVattapparambil/reaxios/blob/master/CONTRIBUTING.md) for details on contributing to the project and [CODE_OF_CONDUCT.md](https://github.com/SandeepVattapparambil/reaxios/blob/master/CODE_OF_CONDUCT.md) for the process for submitting pull requests to us.\n\n#### Versioning\nWe use [SemVer](https://semver.org/) for versioning. For the versions available, see the [tags](https://github.com/SandeepVattapparambil/reaxios/releases) on this repository.\n\n#### Author\nreAxios is written by [Sandeep Vattapparambil](https://github.com/SandeepVattapparambil/)\n\n#### License\nThe MIT License\n\nCopyright (c) 2018- Sandeep Vattapparambil, http://www.sandeepv.in\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n#### Acknowledgements\nMade with :heart: by [Sandeep Vattapparambil](https://github.com/SandeepVattapparambil/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandeepv68%2Freaxios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsandeepv68%2Freaxios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsandeepv68%2Freaxios/lists"}