signUp()
创建一个新的用户。
默认情况下,用户在登录之前需要验证他们的电子邮件地址。要关闭此功能,请在您的项目中禁用 确认电子邮 选项。
确认电子邮件 决定用户在注册后是否需要确认他们的电子邮件地址。
如果启用了 确认电子邮件 ,将返回一个
用户
对象,但会话 (session)
为空。如果禁用了 确认电子邮 ,将返回一个
用户
对象和一个会话 (session)
。
当用户确认他们的电子邮件地址时,默认情况下会重定向到
SITE_URL
。您可以在项目中修改SITE_URL
或在你的项目中添加其他重定向 URL。如果对已确认的现有用户调用 signUp():
- 如果您的项目中启用了 确认电子邮件 ,将返回一个混淆的(假的)的用户对象。
- 如果禁用了 确认电子邮件 ,将返回错误消息
用户已注册
。
- 要获取当前已登录的用户,请参阅 getUser() 方法。
案例教程
案例1 (注册)#
1const { data, error } = await supabase.auth.signUp({
2email: 'example@email.com',
3password: 'example-password',
4})
案例2 (使用附加用户元数据进行注册)#
1const { data, error } = await supabase.auth.signUp(
2{
3 email: 'example@email.com',
4 password: 'example-password',
5 options: {
6 data: {
7 first_name: 'John',
8 age: 27,
9 }
10 }
11}
12)
案例3 (使用重定向URL进行注册)#
1const { data, error } = await supabase.auth.signUp(
2{
3 email: 'example@email.com',
4 password: 'example-password',
5 options: {
6 emailRedirectTo: 'https://example.com/welcome'
7 }
8}
9)
参数说明
credentials[必要参数]
SignUpWithPasswordCredentials
SignUpWithPasswordCredentials是使用密码进行身份验证的一种凭据类型。通常包含以下信息:
1.email(电子邮件):用户的电子邮件地址,作为账户的唯一标识符之一。
2.password(密码):用户选择的密码,用于以后登录时进行身份验证。
3.可能还包含其他一些相关的字段,例如用户名、手机号码或其他自定义的用户信息。