Pular para o conteúdo principal

Callback de erro padrão

Embora seja possível registrar callbacks de erro específicos em cada chamada assíncrona, se você vai sempre empregar a mesma lógica quando um erro ocorrer, é mais prático registrar um callback de erro padrão ao chamar o método init():

pki.init({
    ready: onWebPkiReady,
    defaultFail: onWebPkiFail
});

function onWebPkiFail(ex) {
    alert(ex.userMessage + ' (' + ex.code + ')');
    console.log('Web PKI error originated at ' + ex.origin + ': (' + ex.code + ') ' + ex.error);
}

A partir de então, você pode registrar apenas o callback de sucesso em cada chamada assíncrona.

observação

Quando um erro ocorre e não há callback de erro registrado para a operação, o callback de erro padrão é chamado. Se também não houver callback de erro padrão registrado, uma exceção é lançada.

Códigos de erro​

O campo code da exceção recebida pelo callback de erro indica qual erro ocorreu:

CódigoSignificado
undefinedErro indefinido.
internalErro interno.
user_cancelledO usuário cancelou a operação.
os_not_supportedO sistema operacional do usuário não é suportado.
addon_timeoutO add-on do Internet Explorer não respondeu.
addon_not_detectedO add-on do Internet Explorer não foi detectado: não está instalado ou não está funcionando bem.
addon_send_command_failureO add-on do Internet Explorer não conseguiu enviar o comando ao componente nativo.
certificate_not_foundO certificado selecionado não foi encontrado no repositório do usuário nem no dispositivo criptográfico. Se for usado um dispositivo criptográfico, verifique se os drivers ou a configuração PKCS #11 estão corretos.
command_unknownO comando requisitado é desconhecido.
command_not_supportedO comando requisitado não é suportado no sistema operacional do usuário.
command_parameter_not_setFalta na requisição um parâmetro obrigatório do comando.
command_invalid_parameterUm parâmetro do comando não é válido.
command_parameter_not_supportedUm parâmetro do comando não é suportado nesta plataforma.
native_connect_failureA extensão do navegador não conseguiu se conectar ao componente nativo.
native_disconnectedO componente nativo se desconectou da extensão do navegador.
native_no_responseA extensão do navegador não recebeu resposta do componente nativo.
rest_pki_get_pending_signatureErro ao obter a assinatura pendente no método signWithRestPki(). Veja Erro "Could not get pending signature".
rest_pki_post_signatureErro ao enviar a assinatura no método signWithRestPki().
rest_pki_invalid_certificateO Rest PKI não aceitou o certificado selecionado.
license_not_setUma licença é necessária e não foi configurada. Veja Licenciamento.
license_invalidA licença informada não é válida.
license_restrictedA licença informada não permite o comando requisitado.
license_expiredA licença informada expirou.
license_domain_not_allowedA licença informada não permite o domínio em uso.
validation_errorErro de validação.
p11_errorErro na comunicação PKCS #11.
p11_token_not_foundO dispositivo selecionado não foi encontrado: está desconectado ou o módulo PKCS #11 não foi reconhecido.
p11_not_supportedO dispositivo não suporta a operação PKCS #11 requisitada.
keyset_not_foundA chave privada do certificado selecionado não foi encontrada.
csp_keyset_not_definedChave do certificado não encontrada: verifique se o smart card ou token USB do certificado selecionado está conectado ao computador, ou remova-o e insira-o novamente.
mobile_send_messageNa integração com dispositivo móvel, a biblioteca não conseguiu enviar o comando ao dispositivo.
mobile_timeoutNa integração com dispositivo móvel, o dispositivo não respondeu a tempo.

A biblioteca também define estes códigos, ainda sem descrição: algorithm_not_supported, signed_pdf_to_mark, json_error, io_error, keychain_error, keychain_sign_error, decode_error, csp_invalid_algorithm, csp_invalid_provider_type, mobile_not_authorized, command_decrypt_error, blocked_domain e invalid_operation.

Veja também​

Ver em Markdown