- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
- [`2302c2db`](https://github.com/tauri-apps/plugins-workspace/commit/2302c2db1c49673e61dcbda8cdb01b2c57e9ba6f) ([#1910](https://github.com/tauri-apps/plugins-workspace/pull/1910) by [@Legend-Master](https://github.com/tauri-apps/plugins-workspace/../../Legend-Master)) Fix `ask` and `confirm` not using system button texts
- [`aee14ed4`](https://github.com/tauri-apps/plugins-workspace/commit/aee14ed4261cdedc4ed7cc2686f01f437859a5c7) ([#1892](https://github.com/tauri-apps/plugins-workspace/pull/1892) by [@nashaofu](https://github.com/tauri-apps/plugins-workspace/../../nashaofu)) Set `save` dialog mime type from the `filters` extensions on Android.
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
- [`14cee64c`](https://github.com/tauri-apps/plugins-workspace/commit/14cee64c82a72655ae6a4ac0892736a2959dbda5) ([#1958](https://github.com/tauri-apps/plugins-workspace/pull/1958) by [@bWanShiTong](https://github.com/tauri-apps/plugins-workspace/../../bWanShiTong)) Fix compilation on targets with pointer width of `16` or `32`
## \[2.0.1]
- [`ae802456`](https://github.com/tauri-apps/plugins-workspace/commit/ae8024565f074f313084777c8b10d1b5e3bbe220) ([#1950](https://github.com/tauri-apps/plugins-workspace/pull/1950) by [@amrbashir](https://github.com/tauri-apps/plugins-workspace/../../amrbashir)) Improve performance of the `FileHandle.read` and `writeTextFile` APIs.
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
"description":"This set of permissions describes the what kind of\nfile system access the `fs` plugin has enabled or denied by default.\n\n#### Granted Permissions\n\nThis default permission set enables read access to the\napplication specific directories (AppConfig, AppData, AppLocalData, AppCache,\nAppLog) and all files and sub directories created in it.\nThe location of these directories depends on the operating system,\nwhere the application is run.\n\nIn general these directories need to be manually created\nby the application at runtime, before accessing files or folders\nin it is possible.\n\nTherefore, it is also allowed to create all of these folders via\nthe `mkdir` command.\n\n#### Denied Permissions\n\nThis default permission set prevents access to critical components\nof the Tauri application by default.\nOn Windows the webview data folder access is denied.\n\n",
"description":"This set of permissions describes the what kind of\nfile system access the `fs` plugin has enabled or denied by default.\n\n#### Granted Permissions\n\nThis default permission set enables read access to the\napplication specific directories (AppConfig, AppData, AppLocalData, AppCache,\nAppLog) and all files and sub directories created in it.\nThe location of these directories depends on the operating system,\nwhere the application is run.\n\nIn general these directories need to be manually created\nby the application at runtime, before accessing files or folders\nin it is possible.\n\nTherefore, it is also allowed to create all of these folders via\nthe `mkdir` command.\n\n#### Denied Permissions\n\nThis default permission set prevents access to critical components\nof the Tauri application by default.\nOn Windows the webview data folder access is denied.\n\n#### Included permissions within this default permission set:\n",
- [`cfd48b3b`](https://github.com/tauri-apps/plugins-workspace/commit/cfd48b3b2ec0fccfc162197518694ed59ceda22c) ([#1941](https://github.com/tauri-apps/plugins-workspace/pull/1941) by [@Nipsuli](https://github.com/tauri-apps/plugins-workspace/../../Nipsuli)) Allow skipping sending `Origin` header in HTTP requests by setting `Origin` header to an empty string when calling `fetch`.
- [`9b2840db`](https://github.com/tauri-apps/plugins-workspace/commit/9b2840db9464cf08db75806270e4441f0af81e5d) ([#1884](https://github.com/tauri-apps/plugins-workspace/pull/1884) by [@amrbashir](https://github.com/tauri-apps/plugins-workspace/../../amrbashir)) Retain headers order.
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
eprintln!("[\x1b[33mWARNING\x1b[0m] Skipping {name} header as it is a forbidden header per fetch spec https://fetch.spec.whatwg.org/#terminology-headers");
eprintln!("[\x1b[33mWARNING\x1b[0m] if keeping the header is a desired behavior, you can enable `unsafe-headers` feature flag in your Cargo.toml");
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
- [`3c1f3874`](https://github.com/tauri-apps/plugins-workspace/commit/3c1f3874f4c828637b3aa983cba13c77427faf58) ([#1911](https://github.com/tauri-apps/plugins-workspace/pull/1911) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Added missing permission for `handleIconState` and fixed its event processing logic.
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
- [`51ddf6a7`](https://github.com/tauri-apps/plugins-workspace/commit/51ddf6a71544acfb261ffc9393dab1342da0a219) ([#1881](https://github.com/tauri-apps/plugins-workspace/pull/1881) by [@amrbashir](https://github.com/tauri-apps/plugins-workspace/../../amrbashir)) On Windows, Fix `open` JS API hanging and freezing the app.
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
- [`8c67d44a`](https://github.com/tauri-apps/plugins-workspace/commit/8c67d44aef60b1427019538d8420787ef35bd3d5) ([#1860](https://github.com/tauri-apps/plugins-workspace/pull/1860) by [@Legend-Master](https://github.com/tauri-apps/plugins-workspace/../../Legend-Master)) - Add `getStore`
- Add an option to use pre-stored (de)serialize functions (registered on rust)
- Add `LazyStore`
## \[2.0.1]
- [`a1a82208`](https://github.com/tauri-apps/plugins-workspace/commit/a1a82208ed4ab87f83310be0dc95428aec9ab241) ([#1873](https://github.com/tauri-apps/plugins-workspace/pull/1873) by [@lucasfernog](https://github.com/tauri-apps/plugins-workspace/../../lucasfernog)) Downgrade MSRV to 1.77.2 to support Windows 7.
@ -125,3 +133,11 @@
com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
plugins-workspace/pull/371)) First v2 alpha release!
com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
) First v2 alpha release!
com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
eb4492fac1f295998b93f2b9347f)([#371](https://github.com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
ps://github.com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
717ae670978feb4492fac1f295998b93f2b9347f)([#371](https://github.com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
plugins-workspace/pull/371)) First v2 alpha release!
com/tauri-apps/plugins-workspace/pull/371)) First v2 alpha release!
@ -70,7 +70,7 @@ Afterwards all the plugin's APIs are available through the JavaScript guest bind
```typescript
import { Store } from '@tauri-apps/plugin-store'
const store = new Store('.settings.dat')
const store = await Store.load('settings.json')
await store.set('some-key', { value: 5 })
@ -81,14 +81,11 @@ if (val) {
} else {
console.log('val is null')
}
// This manually saves the store.
await store.save()
```
### Persisting Values
As seen above, values added to the store are not persisted between application loads unless the application is closed gracefully.
Modifications made to the store are automatically saved by default
You can manually save a store with:
@ -103,65 +100,43 @@ However, you can also load them manually later like so:
await store.load()
```
### LazyStore
There's also a high level API `LazyStore` which only loads the store on first access, note that the options will be ignored if a `Store` with that path has already been created
```typescript
import { LazyStore } from '@tauri-apps/plugin-store'
const store = new LazyStore('settings.json')
```
## Usage from Rust
You can also create `Store` instances directly in Rust:
let mut store = StoreBuilder::new("app_data.bin").build(app.handle().clone());
// Attempt to load the store, if it's saved already.
store.load().expect("Failed to load store from disk");
// This loads the store from disk
let store = app.store("app_data.json")?;
// Note that values must be serde_json::Value instances,
// otherwise, they will not be compatible with the JavaScript bindings.
store.insert("a".to_string(), json!("b"));
// You can manually save the store after making changes.
// Otherwise, it will save upon graceful exit as described above.
store.save()
store.set("a".to_string(), json!("b"));
})
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
```
### Loading Gracefully
If you call `load` on a `Store` that hasn't yet been written to the disk, it will return an error. You must handle this error if you want to gracefully continue and use the default store until you save it to the disk. The example above shows how to do this.
For example, this would cause a panic if the store has not yet been created:
```rust
store.load().unwrap();
```
Rather than silently continuing like you may expect.
You should always handle the error appropriately rather than unwrapping, or you may experience unexpected app crashes:
```rust
store.load().expect("Failed to load store from disk");
```
### Frontend Interoperability
As you may have noticed, the `Store` crated above isn't accessible to the frontend. To interoperate with stores created by JavaScript use the exported `with_store` method:
```rust
use tauri::Wry;
use tauri_plugin_store::StoreExt;
let store = app.store_builder("app_data.bin").build();
store.insert("key", "value");
```
The store created from both Rust side and JavaScript side are stored in the app's resource table and can be accessed by both sides, you can access it by using the same path, with `getStore` and `LazyStore` in the JavaScript side and `get_store` and `store` in the Rust side
if("__TAURI__"inwindow){var__TAURI_PLUGIN_STORE__=function(e){"use strict";vart,r;functiona(e,t=!1){returnwindow.__TAURI_INTERNALS__.transformCallback(e,t)}asyncfunctioni(e,t={},r){returnwindow.__TAURI_INTERNALS__.invoke(e,t,r)}"function"==typeofSuppressedError&&SuppressedError;classn{getrid(){returnfunction(e,t,r,a){if("a"===r&&!a)thrownewTypeError("Private accessor was defined without a getter");if("function"==typeoft?e!==t||!a:!t.has(e))thrownewTypeError("Cannot read private member from an object whose class did not declare it");return"m"===r?a:"a"===r?a.call(e):a?a.value:t.get(e)}(this,t,"f")}constructor(e){t.set(this,void0),function(e,t,r,a,i){if("function"==typeoft?e!==t||!i:!t.has(e))thrownewTypeError("Cannot write private member to an object whose class did not declare it");t.set(e,r)}(this,t,e)}asyncclose(){returni("plugin:resources|close",{rid:this.rid})}}asyncfunctions(e,t,r){constn={kind:"Any"};returni("plugin:event|listen",{event:e,target:n,handler:a(t)}).then((t=>async()=>asyncfunction(e,t){awaiti("plugin:event|unlisten",{event:e,eventId:t})}(e,t)))}t=newWeakMap,function(e){e.WINDOW_RESIZED="tauri://resize",e.WINDOW_MOVED="tauri://move",e.WINDOW_CLOSE_REQUESTED="tauri://close-requested",e.WINDOW_DESTROYED="tauri://destroyed",e.WINDOW_FOCUS="tauri://focus",e.WINDOW_BLUR="tauri://blur",e.WINDOW_SCALE_FACTOR_CHANGED="tauri://scale-change",e.WINDOW_THEME_CHANGED="tauri://theme-changed",e.WINDOW_CREATED="tauri://window-created",e.WEBVIEW_CREATED="tauri://webview-created",e.DRAG_ENTER="tauri://drag-enter",e.DRAG_OVER="tauri://drag-over",e.DRAG_DROP="tauri://drag-drop",e.DRAG_LEAVE="tauri://drag-leave"}(r||(r={}));classoextendsn{constructor(e,t){super(e),this.path=t}asyncset(e,t){awaiti("plugin:store|set",{rid:this.rid,key:e,value:t})}asyncget(e){returnawaiti("plugin:store|get",{rid:this.rid,key:e})}asynchas(e){returnawaiti("plugin:store|has",{rid:this.rid,key:e})}asyncdelete(e){returnawaiti("plugin:store|delete",{rid:this.rid,key:e})}asyncclear(){awaiti("plugin:store|clear",{rid:this.rid})}asyncreset(){awaiti("plugin:store|reset",{rid:this.rid})}asynckeys(){returnawaiti("plugin:store|keys",{rid:this.rid})}asyncvalues(){returnawaiti("plugin:store|values",{rid:this.rid})}asyncentries(){returnawaiti("plugin:store|entries",{rid:this.rid})}asynclength(){returnawaiti("plugin:store|length",{rid:this.rid})}async load(){awaiti("plugin:store|load",{rid:this.rid})}asyncsave(){awaiti("plugin:store|save",{rid:this.rid})}asynconKeyChange(e,t){returnawaits("store://change",(r=>{r.payload.path===this.path&&r.payload.key===e&&t(r.payload.value)}))}asynconChange(e){returnawaits("store://change",(t=>{t.payload.path===this.path&&e(t.payload.key,t.payload.value)}))}}returne.Store=o,e.createStore=asyncfunction(e,t){constr=awaiti("plugin:store|create_store",{path:e,...t});returnnewo(r,e)},e}({});Object.defineProperty(window.__TAURI__,"store",{value:__TAURI_PLUGIN_STORE__})}
if("__TAURI__"inwindow){var__TAURI_PLUGIN_STORE__=function(t){"use strict";vare,a;functionr(t,e=!1){returnwindow.__TAURI_INTERNALS__.transformCallback(t,e)}asyncfunctions(t,e={},a){returnwindow.__TAURI_INTERNALS__.invoke(t,e,a)}"function"==typeofSuppressedError&&SuppressedError;classi{getrid(){returnfunction(t,e,a,r){if("a"===a&&!r)thrownewTypeError("Private accessor was defined without a getter");if("function"==typeofe?t!==e||!r:!e.has(t))thrownewTypeError("Cannot read private member from an object whose class did not declare it");return"m"===a?r:"a"===a?r.call(t):r?r.value:e.get(t)}(this,e,"f")}constructor(t){e.set(this,void0),function(t,e,a,r,s){if("function"==typeofe?t!==e||!s:!e.has(t))thrownewTypeError("Cannot write private member to an object whose class did not declare it");e.set(t,a)}(this,e,t)}asyncclose(){returns("plugin:resources|close",{rid:this.rid})}}asyncfunctionn(t,e,a){consti={kind:"Any"};returns("plugin:event|listen",{event:t,target:i,handler:r(e)}).then((e=>async()=>asyncfunction(t,e){awaits("plugin:event|unlisten",{event:t,eventId:e})}(t,e)))}asyncfunctiono(t,e){returnawaitu.load(t,e)}e=newWeakMap,function(t){t.WINDOW_RESIZED="tauri://resize",t.WINDOW_MOVED="tauri://move",t.WINDOW_CLOSE_REQUESTED="tauri://close-requested",t.WINDOW_DESTROYED="tauri://destroyed",t.WINDOW_FOCUS="tauri://focus",t.WINDOW_BLUR="tauri://blur",t.WINDOW_SCALE_FACTOR_CHANGED="tauri://scale-change",t.WINDOW_THEME_CHANGED="tauri://theme-changed",t.WINDOW_CREATED="tauri://window-created",t.WEBVIEW_CREATED="tauri://webview-created",t.DRAG_ENTER="tauri://drag-enter",t.DRAG_OVER="tauri://drag-over",t.DRAG_DROP="tauri://drag-drop",t.DRAG_LEAVE="tauri://drag-leave"}(a||(a={}));classuextendsi{constructor(t){super(t)}staticasyncload(t,e){consta=awaits("plugin:store|load",{path:t,...e});returnnewu(a)}staticasyncget(t){returnawaits("plugin:store|get_store",{path:t}).then((t=>t?newu(t):null))}asyncset(t,e){awaits("plugin:store|set",{rid:this.rid,key:t,value:e})}asyncget(t){const[e,a]=awaits("plugin:store|get",{rid:this.rid,key:t});returna?e:void0}asynchas(t){returnawaits("plugin:store|has",{rid:this.rid,key:t})}asyncdelete(t){returnawaits("plugin:store|delete",{rid:this.rid,key:t})}asyncclear(){awaits("plugin:store|clear",{rid:this.rid})}asyncreset(){awaits("plugin:store|reset",{rid:this.rid})}asynckeys(){returnawaits("plugin:store|keys",{rid:this.rid})}asyncvalues(){returnawaits("plugin:store|values",{rid:this.rid})}asyncentries(){returnawaits("plugin:store|entries",{rid:this.rid})}asynclength(){returnawaits("plugin:store|length",{rid:this.rid})}asyncreload(){awaits("plugin:store|reload",{rid:this.rid})}asyncsave(){awaits("plugin:store|save",{rid:this.rid})}asynconKeyChange(t,e){returnawaitn("store://change",(a=>{a.payload.resourceId===this.rid&&a.payload.key===t&&e(a.payload.exists?a.payload.value:void0)}))}asynconChange(t){returnawaitn("store://change",(e=>{e.payload.resourceId===this.rid&&t(e.payload.key,e.payload.exists?e.payload.value:void0)}))}}returnt.LazyStore=class{getstore(){returnthis._store||(this._store=o(this.path,this.options)),this._store}constructor(t,e){this.path=t,this.options=e}asyncinit(){awaitthis.store}asyncset(t,e){return(awaitthis.store).set(t,e)}asyncget(t){return(awaitthis.store).get(t)}asynchas(t){return(awaitthis.store).has(t)}asyncdelete(t){return(awaitthis.store).delete(t)}asyncclear(){await(awaitthis.store).clear()}asyncreset(){await(awaitthis.store).reset()}asynckeys(){return(awaitthis.store).keys()}asyncvalues(){return(awaitthis.store).values()}asyncentries(){return(awaitthis.store).entries()}asynclength(){return(awaitthis.store).length()}asyncreload(){await(awaitthis.store).reload()}asyncsave(){await(awaitthis.store).save()}asynconKeyChange(t,e){return(awaitthis.store).onKeyChange(t,e)}asynconChange(t){return(awaitthis.store).onChange(t)}asyncclose(){this._store&&await(awaitthis._store).close()}},t.Store=u,t.getStore=asyncfunction(t){returnawaitu.get(t)},t.load=o,t}({});Object.defineProperty(window.__TAURI__,"store",{value:__TAURI_PLUGIN_STORE__})}
jLynx
9 months ago
committed by
GitHub