How stable is v1?

[KrisLau]

Describe the issue

Hi, really appreciate all the work that's being done on the library now! I'm deciding whether or not to upgrade from v0.27.2 to v1.1.2 or if I should wait for a more stable version. I'm unsure how stable v1 is as I've seen a bunch of issues related to v1. I also was wondering if there will be a migration guide written for upgrading to v1.

Example Code

N/A

Expected behavior, if applicable

N/A

Environment

• Axios Version - v0.27.2
• Adapter - HTTP
• Browser - N/A
• Browser Version - N/A
• Node.js Version - v16.16.0
• OS: - N/A
• Additional Library Versions - React Native v0.69.6

Additional context/Screenshots

N/A

[ghost]

FWIW there are a few breaking changes (paramsSerializer behavior is completely different), plus the documentation needs to be updated. There is a PR to resolve the Params Serializer issue and update some of the docs. See #5108

[ddolcimascolo]

It's not. The Jest tests breakage is a show stopper by itself, there's the paramsSerializer issue @EfChouTR is talking about, the set-cookie header issue, and the long list of open, unrsponded issues.

[KieraDOG]

there are few typescript break changes as well,

ie. you are no longer allowed to do this in axios v1 ts

api.interceptors.response.use((response: AxiosResponse): unknown => response.data)

[jasonsaayman]

Yeah, there are a couple of issues, and I am trying to resolve a lot of them. Will be working on getting it more stable tonight. Staying on v0.27.2 is still an option, we are not dropping support for that and a new v0.xx version will be released soon.

[KrisLau]

Yeah, there are a couple of issues, and I am trying to resolve a lot of them. Will be working on getting it more stable tonight. Staying on v0.27.2 is still an option, we are not dropping support for that and a new v0.xx version will be released soon.

Sounds good, thanks for all the great work!

[KrisLau]

@jasonsaayman Hi, sorry to bother but I just wanted to check in with a related question! Will there be an announcement made when a stable version is reached? I'm unsure when I should start migrating to v1 and just wanted to know if there will be an official announcement or if I would need to figure that out on my own (or if a stable version has already been reached).

Also will there will be a migration guide written for upgrading to v1?