多用户应用程序 - Node.js SDK
Realm 软件开发工具包（Realm SDK）允许多个用户在给定设备上同时登录应用。 即使多个用户同时登录， Realm 客户端应用程序也会在单个活动用户的上下文中运行。 您可以在经过身份验证的用户之间快速切换，而无需他们再次登录。
重要
任何登录用户都可以成为活动用户，而无需重新进行身份验证。 这可能是一个安全漏洞，具体取决于您的应用程序。 例如，共享设备上的用户可以切换到同事的登录帐户，而无需提供他们的凭证或征求他们的明确许可。 如果您的应用程序需要更严格的身份验证，请避免在用户之间切换，并且最好在对其他用户进行身份验证之前显式注销活动用户。
用户账户状态
当用户首次通过给定设备或浏览器上的 Realm 软件开发工具包（Realm SDK）登录时，软件开发工具包（SDK）会保存用户的信息并追踪用户在设备上的状态。即使用户注销，其数据仍会保留在设备上，除非您主动删除用户。
以下状态描述了设备上的用户在任何给定时间的状态：
已通过身份验证：已登录设备且未注销或撤销会话的任何用户。
已注销：在设备上进行身份验证但已注销或已撤销会话的任何用户。
下图显示了发生某些事件时，App Services 客户端应用程序中的用户如何在状态之间进行转换：
向设备添加新用户
当用户首次登录设备时，Realm SDK 会自动将用户添加到该设备。 用户登录后，将立即成为应用程序的活跃用户。
例子
在以下示例中，电子邮件为 joe@example.com的用户登录并成为活跃用户。随后，电子邮件地址为emma@example.com的用户登录并成为活动用户。
const app = new Realm.App({ id: "myapp-abcde" }); // Log in as Joe const joeCredentials = Realm.Credentials.emailPassword("joe@example.com", "passw0rd") const joe = await app.logIn(joeCredentials); // The active user is now Joe assert(joe.id === app.currentUser.id); // Log in as Emma const emmaCredentials = Realm.Credentials.emailPassword("emma@example.com", "pa55word") const emma = await app.logIn(emmaCredentials); // The active user is now Emma, but Joe is still logged in assert(emma.id === app.currentUser.id);
const app = new Realm.App({ id: "myapp-abcde" }); // Log in as Joe const joeCredentials = Realm.Credentials.emailPassword("joe@example.com", "passw0rd") const joe = await app.logIn(joeCredentials); // The active user is now Joe assert(joe.id === app.currentUser.id); // Log in as Emma const emmaCredentials = Realm.Credentials.emailPassword("emma@example.com", "pa55word") const emma = await app.logIn(emmaCredentials); // The active user is now Emma, but Joe is still logged in assert(emma.id === app.currentUser.id);
列出设备上的所有用户
您可以访问权限设备上所有用户帐户的列表。 此列表包括已在给定设备上登录客户端应用的所有用户。
例子
在下面的示例中，开发者通过循环Realm.App.allUsers 打印出设备上的所有登录用户。
// Get a list of all Users app.allUsers.forEach(user => { console.log(`User with id ${user.id} is ${user.isLoggedIn ? "logged in" : "logged out"}`); });
// Get a list of all Users app.allUsers.forEach((user: Realm.User) => { console.log(`User with id ${user.id} is ${user.isLoggedIn ? "logged in" : "logged out"}`); });
从设备上删除用户
您可以从设备中删除有关用户的所有信息并自动注销用户。
例子
在以下示例中，使用Realm.App.removeUser()从设备中删除当前用户 方法。
// Remove the current user from the device const user = app.currentUser; await app.removeUser(user); // The user is no longer the active user if(app.currentUser) { // The active user is now the logged in user (if there still is one) that was // most recently active assert(user.id !== app.currentUser.id) } // The user is no longer on the device assert(app.allUsers.find(({ id }) => id === user.id) === undefined);
// Remove the current user from the device const user = app.currentUser; await app.removeUser(user); // The user is no longer the active user // The active user is now the logged in user (if there still is one) that was // most recently active assert(user.id !== app.currentUser?.id) // The removed user is no longer on the device assert(app.allUsers.find(({ id }) => id === user.id) === undefined);
更改活动用户
您可以随时将应用的活跃用户快速切换为其他登录用户。
例子
在下面的示例中，活动用户最初使用Realm.App.switchUser()切换到user1 。 方法。 随后，活动用户切换为user2 。
// Get some logged-in users const authenticatedUsers = app.allUsers.filter(user => user.isLoggedIn); const user1 = authenticatedUsers[0]; const user2 = authenticatedUsers[1]; // Switch to user1 app.switchUser(user1); // The active user is now user1 assert(app.currentUser.id === user1.id); // Switch to user2 app.switchUser(user2); // The active user is now user2 assert(app.currentUser.id === user2.id);
// Get some logged-in users const authenticatedUsers = app.allUsers.filter(user => user.isLoggedIn); const user1 = authenticatedUsers[0]; const user2 = authenticatedUsers[1]; // Switch to user1 app.switchUser(user1); // The active user is now user1 assert(app.currentUser.id === user1.id); // Switch to user2 app.switchUser(user2); // The active user is now user2 assert(app.currentUser.id === user2.id);