  var _userId, _passwd;

  function login(loginUrl, userId, passwd) {
      _userId = userId;
      _passwd = passwd;
      var networkState = navigator.connection.type;
      if (networkState == Connection.UNKNOWN || networkState == Connection.NONE){
          imaps.auth.loginOffline(resultHandler, errorHandler, _userId, _passwd);
      }
      else{
          imaps.auth.loginOnline(
              resultHandler, 
              function(result){
                  if (result == "IMAPSAuthConnectError")
                      imaps.auth.loginOffline(resultHandler, errorHandler, _userId, _passwd);
                   else
                       console.log("Login failure:" + result);
              }, 
              loginUrl, 
              _userId, 
              _passwd);
      }
  }
  function resultHandler(result) {
      console.log("Login success:" + result );
  }
  function errorHandler(error) {
      console.log("Login failure:" + error );
  }

オフライン認証とは、クライアントが保持しているクレデンシャルを用いて利用ユーザーの正当性を検証する認証です。IMAPSサーバの認証機構を利用しないため、ネットワークが利用できない状態でも認証を行うことができます。オフライン認証を行うためには、オンライン認証で一度、認証を完了しておく必要があります。
ネットワーク状態を気にせずにログインを実行したい場合には、imaps.auth.loginAutoメソッドを呼びます。loginAutoメソッドは、最適なログイン方法をネットワーク状態に応じて選択します。

ポイント

オンライン認証では、接続先のサーバをクライアント設定ファイルのimapsServerAddressで設定することも可能です。詳細は、開発者用マニュアル、付録C クライアント設定ファイルを参照してください。
認証プラグインでログインすることで、認証情報を付与することができます。

注意

Androidの場合、ログアウトを呼び出さずにアプリケーションを終了すると、再度アプリケーションを起動した時、ユーザー情報や認証情報が残ったままになっている場合があります。アプリケーションの終了時、または起動時にログアウトを呼び出し、ユーザー情報を初期化してください。

2.3.28.2.1 ログイン