Session object constructor. Typically called as follows:
const session = new Session();
See also getDefaultSession.
The options enabling the correct instantiation of the session. Either both storages or clientAuthentication are required. For more information, see ISessionOptions.
A string uniquely identifying the session.
ReadonlyeventsSession attribute exposing the EventEmitter interface, to listen on session events such as login, logout, etc.
Fetches data using available login information. If the user is not logged in, this will behave as a regular fetch. The signature of this method is identical to the canonical fetch.
Optionalinit: RequestInitOptionalinit: RequestInitOptional parameters customizing the request, by specifying an HTTP method, headers, a body, etc. Follows the WHATWG Fetch Standard.
ReadonlyinfoInformation regarding the current session.
Completes the login process by processing the information provided by the Solid identity provider through redirect.
Triggers the login process. Note that this method will redirect the user away from your app.
Parameter to customize the login behaviour. In particular, two options are mandatory: options.oidcIssuer, the user's identity provider, and options.redirectUrl, the URL to which the user will be redirected after logging in their identity provider.
This method should redirect the user away from the app: it does not return anything. The login process is completed by handleIncomingRedirect.
Logs the user out of the application.
There are 2 types of logout supported by this library,
app logout and idp logout.
App logout will log the user out within the application by clearing any session data from the browser. It does not log the user out of their Solid identity provider, and should not redirect the user away. App logout can be performed as follows:
await session.logout({ logoutType: 'app' });
IDP logout will log the user out of their Solid identity provider,
and will redirect the user away from the application to do so. In order
for users to be redirected back to postLogoutUrl you MUST include the
postLogoutUrl value in the post_logout_redirect_uris field in the
Client ID Document.
IDP logout can be performed as follows:
await session.logout({
logoutType: 'idp',
// An optional URL to redirect to after logout has completed;
// this MUST match a logout URL listed in the Client ID Document
// of the application that is logged in.
// If the application is logged in with a Client ID that is not
// a URI dereferencing to a Client ID Document then users will
// not be redirected back to the `postLogoutUrl` after logout.
postLogoutUrl: 'https://example.com/logout',
// An optional value to be included in the query parameters
// when the IDP provider redirects the user to the postLogoutRedirectUrl.
state: "my-state"
});
Optionaloptions: ILogoutOptions
A Session object represents a user's session on an application. The session holds state, as it stores information enabling access to private resources after login for instance.