Register Method
This method registers an account with a server.
Syntax
xmpp.register(XMPPServer, [callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
Before a registration can be attempted, the application should use the QueryRegister method to poll the host to which the user wishes to register. This will gather all of the necessary fields that the user must send to the server, and will populate the UserInfo properties accordingly. After a successful query, all entries in UserInfo values will be empty strings.
The possible registration fields are defined in the Jabber protocol specification as follows:
| instructions | Special instructions sent from the server. |
| username | The username to be associated with this account. |
| password | The initial password for this account. |
| name | The user's name. |
| The user's email address. | |
| address | The user's physical address. |
| city | The user's city of residence. |
| state | The user's state (for United States citizens). |
| zip | The user's postal code (for United States citizens). |
| phone | The user's phone number. |
| URL | The user's website. |
| date | The date of registration. |
| misc | Any miscellaneous data. |
| text | Any extra text (potentially for a personal bio). |
| remove | Specifies a request to unregister. |
After the user has set all of the values in UserInfo, and added any extra fields they may wish to include in their registration, the application should make a call to Register.
If the class is not already connected when this method is called, it will connect, poll the registration fields, and then disconnect.
A new account can be registered at any time, including while the class is logged into the host under an existing account.