This is an automated email from the ASF dual-hosted git repository.
erisu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 7f9685af13 doc(ios): add webkit storage policy note to localStorage &
IndexedDB (#1427)
7f9685af13 is described below
commit 7f9685af13154e42d0f5b474d230561c689babcc
Author: エリス <er...@users.noreply.github.com>
AuthorDate: Mon Jul 14 11:23:32 2025 +0900
doc(ios): add webkit storage policy note to localStorage & IndexedDB (#1427)
---
www/docs/en/12.x-2025.01/cordova/storage/storage.md | 8 ++++----
www/docs/en/12.x/cordova/storage/storage.md | 8 ++++----
www/docs/en/dev/cordova/storage/storage.md | 8 ++++----
3 files changed, 12 insertions(+), 12 deletions(-)
diff --git a/www/docs/en/12.x-2025.01/cordova/storage/storage.md
b/www/docs/en/12.x-2025.01/cordova/storage/storage.md
index de74c52e3a..840a7183a3 100644
--- a/www/docs/en/12.x-2025.01/cordova/storage/storage.md
+++ b/www/docs/en/12.x-2025.01/cordova/storage/storage.md
@@ -64,15 +64,13 @@ For more information, see:
### Disadvantages
-- Only stores strings, so complex data structures have to be serialized,
- and only data that can be serialized can be stored.
+- Only stores strings, so complex data structures have to be serialized, and
only data that can be serialized can be stored.
- Performs poorly with large amounts of data. In particular:
- The lack of indexing means searches require manually iterating all data.
- Storing large or complex items is slow due to the need to
serialize/de-serialize.
- Synchronous API means calls will lock up the user interface.
- Limited total amount of storage (typically around 5MB).
-- iOS stores `localStorage` data in a location that may be cleaned out by
- the OS when space is required.
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## IndexedDB
@@ -187,6 +185,7 @@ For more information, see:
- Complex API with nested callbacks.
- Limited total amount of storage and possible eviction [as described on
MDN][MDNIndexedDBLimitsAndEviction].
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## Plugin-Based Options
@@ -219,6 +218,7 @@ It is available in the following variations:
Search [Cordova plugins][CordovaPlugins] for other plugins that provide
alternative storage options.
+[WebKitUpdatesToStoragePolicy]:
https://webkit.org/blog/14403/updates-to-storage-policy/
[Html5RocksStorageOverview]: http://www.html5rocks.com/en/features/storage
[Html5RocksStorageTutorial]:
http://www.html5rocks.com/en/tutorials/offline/storage/
[W3CSpecStorage]: https://html.spec.whatwg.org/multipage/webstorage.html
diff --git a/www/docs/en/12.x/cordova/storage/storage.md
b/www/docs/en/12.x/cordova/storage/storage.md
index de74c52e3a..840a7183a3 100644
--- a/www/docs/en/12.x/cordova/storage/storage.md
+++ b/www/docs/en/12.x/cordova/storage/storage.md
@@ -64,15 +64,13 @@ For more information, see:
### Disadvantages
-- Only stores strings, so complex data structures have to be serialized,
- and only data that can be serialized can be stored.
+- Only stores strings, so complex data structures have to be serialized, and
only data that can be serialized can be stored.
- Performs poorly with large amounts of data. In particular:
- The lack of indexing means searches require manually iterating all data.
- Storing large or complex items is slow due to the need to
serialize/de-serialize.
- Synchronous API means calls will lock up the user interface.
- Limited total amount of storage (typically around 5MB).
-- iOS stores `localStorage` data in a location that may be cleaned out by
- the OS when space is required.
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## IndexedDB
@@ -187,6 +185,7 @@ For more information, see:
- Complex API with nested callbacks.
- Limited total amount of storage and possible eviction [as described on
MDN][MDNIndexedDBLimitsAndEviction].
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## Plugin-Based Options
@@ -219,6 +218,7 @@ It is available in the following variations:
Search [Cordova plugins][CordovaPlugins] for other plugins that provide
alternative storage options.
+[WebKitUpdatesToStoragePolicy]:
https://webkit.org/blog/14403/updates-to-storage-policy/
[Html5RocksStorageOverview]: http://www.html5rocks.com/en/features/storage
[Html5RocksStorageTutorial]:
http://www.html5rocks.com/en/tutorials/offline/storage/
[W3CSpecStorage]: https://html.spec.whatwg.org/multipage/webstorage.html
diff --git a/www/docs/en/dev/cordova/storage/storage.md
b/www/docs/en/dev/cordova/storage/storage.md
index de74c52e3a..840a7183a3 100644
--- a/www/docs/en/dev/cordova/storage/storage.md
+++ b/www/docs/en/dev/cordova/storage/storage.md
@@ -64,15 +64,13 @@ For more information, see:
### Disadvantages
-- Only stores strings, so complex data structures have to be serialized,
- and only data that can be serialized can be stored.
+- Only stores strings, so complex data structures have to be serialized, and
only data that can be serialized can be stored.
- Performs poorly with large amounts of data. In particular:
- The lack of indexing means searches require manually iterating all data.
- Storing large or complex items is slow due to the need to
serialize/de-serialize.
- Synchronous API means calls will lock up the user interface.
- Limited total amount of storage (typically around 5MB).
-- iOS stores `localStorage` data in a location that may be cleaned out by
- the OS when space is required.
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## IndexedDB
@@ -187,6 +185,7 @@ For more information, see:
- Complex API with nested callbacks.
- Limited total amount of storage and possible eviction [as described on
MDN][MDNIndexedDBLimitsAndEviction].
+- On iOS systems, WebKit may delete web-related data storage when the device
is under storage pressure or exceeds defined storage quotas. This eviction is
triggered by WebKit itself, based on its internal quota management policies.
For more information, see [WebKit – Updates to Storage
Policy][WebKitUpdatesToStoragePolicy].
## Plugin-Based Options
@@ -219,6 +218,7 @@ It is available in the following variations:
Search [Cordova plugins][CordovaPlugins] for other plugins that provide
alternative storage options.
+[WebKitUpdatesToStoragePolicy]:
https://webkit.org/blog/14403/updates-to-storage-policy/
[Html5RocksStorageOverview]: http://www.html5rocks.com/en/features/storage
[Html5RocksStorageTutorial]:
http://www.html5rocks.com/en/tutorials/offline/storage/
[W3CSpecStorage]: https://html.spec.whatwg.org/multipage/webstorage.html
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
