diff --git a/docs/api/session.md b/docs/api/session.md index c89ef396d72a..7e933743c9d9 100644 --- a/docs/api/session.md +++ b/docs/api/session.md @@ -817,6 +817,11 @@ Returns `Extension[]` - A list of all loaded extensions. **Note:** This API cannot be called before the `ready` event of the `app` module is emitted. +#### `ses.getStoragePath()` + +A `String | null` indicating the absolute file system path where data for this +session is persisted on disk. For in memory sessions this returns `null`. + ### Instance Properties The following properties are available on instances of `Session`: @@ -830,6 +835,11 @@ code to the `setSpellCheckerLanguages` API that isn't in this array will result A `Boolean` indicating whether builtin spell checker is enabled. +#### `ses.storagePath` _Readonly_ + +A `String | null` indicating the absolute file system path where data for this +session is persisted on disk. For in memory sessions this returns `null`. + #### `ses.cookies` _Readonly_ A [`Cookies`](cookies.md) object for this session. diff --git a/shell/browser/api/electron_api_session.cc b/shell/browser/api/electron_api_session.cc index 16fb548b60a8..514cad905797 100644 --- a/shell/browser/api/electron_api_session.cc +++ b/shell/browser/api/electron_api_session.cc @@ -964,6 +964,13 @@ v8::Local Session::CloseAllConnections() { return handle; } +v8::Local Session::GetPath(v8::Isolate* isolate) { + if (browser_context_->IsOffTheRecord()) { + return v8::Null(isolate); + } + return gin::ConvertToV8(isolate, browser_context_->GetPath()); +} + #if BUILDFLAG(ENABLE_BUILTIN_SPELLCHECKER) base::Value Session::GetSpellCheckerLanguages() { return browser_context_->prefs() @@ -1188,11 +1195,13 @@ gin::ObjectTemplateBuilder Session::GetObjectTemplateBuilder( #endif .SetMethod("preconnect", &Session::Preconnect) .SetMethod("closeAllConnections", &Session::CloseAllConnections) + .SetMethod("getStoragePath", &Session::GetPath) .SetProperty("cookies", &Session::Cookies) .SetProperty("netLog", &Session::NetLog) .SetProperty("protocol", &Session::Protocol) .SetProperty("serviceWorkers", &Session::ServiceWorkerContext) - .SetProperty("webRequest", &Session::WebRequest); + .SetProperty("webRequest", &Session::WebRequest) + .SetProperty("storagePath", &Session::GetPath); } const char* Session::GetTypeName() { diff --git a/shell/browser/api/electron_api_session.h b/shell/browser/api/electron_api_session.h index 317c4a2985c7..1e56fc357d6d 100644 --- a/shell/browser/api/electron_api_session.h +++ b/shell/browser/api/electron_api_session.h @@ -124,6 +124,7 @@ class Session : public gin::Wrappable, v8::Local NetLog(v8::Isolate* isolate); void Preconnect(const gin_helper::Dictionary& options, gin::Arguments* args); v8::Local CloseAllConnections(); + v8::Local GetPath(v8::Isolate* isolate); #if BUILDFLAG(ENABLE_BUILTIN_SPELLCHECKER) base::Value GetSpellCheckerLanguages(); void SetSpellCheckerLanguages(gin_helper::ErrorThrower thrower, diff --git a/spec-main/api-session-spec.ts b/spec-main/api-session-spec.ts index 295acdd16f6a..9ffce8e19463 100644 --- a/spec-main/api-session-spec.ts +++ b/spec-main/api-session-spec.ts @@ -1090,6 +1090,24 @@ describe('session module', () => { }); }); + describe('session.storagePage', () => { + it('returns a string', () => { + expect(session.defaultSession.storagePath).to.be.a('string'); + }); + + it('returns null for in memory sessions', () => { + expect(session.fromPartition('in-memory').storagePath).to.equal(null); + }); + + it('returns different paths for partitions and the default session', () => { + expect(session.defaultSession.storagePath).to.not.equal(session.fromPartition('persist:two').storagePath); + }); + + it('returns different paths for different partitions', () => { + expect(session.fromPartition('persist:one').storagePath).to.not.equal(session.fromPartition('persist:two').storagePath); + }); + }); + describe('ses.setSSLConfig()', () => { it('can disable cipher suites', async () => { const ses = session.fromPartition('' + Math.random());