Migration guide to the new package
June 3, 2026 ยท View on GitHub
This library has been renamed from angular-async-local-storage to @ngx-pwa/local-storage.
But do not worry: the previous package is still here and will be as long as npm exists. Migration to the new package is recommended as soon as possible to enjoy bug fixes and new features, but is not required for Angular 4 & 5. It is only required when upgrading to Angular >= 6.
Versions
- v10 for Angular 10,
- v11 for Angular 11,
- v12 for Angular 12,
- v13 for Angular 13 & 14,
- v15 for Angular 15,
- v16 for Angular 16,
- v17 for Angular 17,
- v18 for Angular 18,
- v19 for Angular 19,
- v20 for Angular 20,
- v21 for Angular 21,
- v22 for Angular 22.
Angular <= 19 are officially outdated.
Installing the new package
The migration is very easy. First, install the new package:
- for Angular 4 (meaning you come from
angular-async-local-storageversion 2):
npm install @ngx-pwa/local-storage@4
- for Angular 5 (meaning you come from
angular-async-local-storageversion 3):
npm install @ngx-pwa/local-storage@5
- for Angular 6 & 7:
npm install @ngx-pwa/local-storage@6
- for Angular >= 8: you must update to v6 first, then do the other migrations in an incremental way, especially the version 9 migration, as it can lead to the loss of all previsouly stored data if it is not done correctly.
Refactoring
Then, do a global search of angular-async-local-storage in your project, and replace with @ngx-pwa/local-storage.
Finally, you can uninstall the previous package:
npm uninstall angular-async-local-storage
Done.
Code changes
There is no code change in v4 and v5.
There are code changes if you are upgrading to Angular >=6, see the other migration guides.