Uma promise é exatamente o que o nome diz, uma promessa. Sua função "promete" que vai retornar algo, esse algo pode ser um sucesso, erro, mensagem e etc.
O que você vai fazer com o que foi retornado do promise
é um callback
. Ou seja, uma promise
retorna um dado e o callback
trata esse dado.
O método Ajax
do jQuery
que você deu como exemplo é um exemplo de promise
.
// função principal que retorna a promise
var ajax = $.ajax('url');
// promise retornou sucesso (resolve) então podemos tratar os dados
ajax.done(function( data ) {
// do something awesome
})
// promise retornou erro (reject) então precisamos tratar o erro
ajax.fail(function( error ){
// something went wrong
});
No exemplo que você deu não é necessário encapsular o Ajax
numa promise
porque o Ajax
em si já é uma promise
.
Veja outro exemplo de promise
var preload = function( url ) {
return new Promise(function( resolve, reject ) {
var image = new Image();
image.onload = function() {
resolve( image );
};
image.onerror = function() {
reject( Error('Error while loading image: ' + url)) ;
};
image.src = url;
});
};
E para usar
var preloadImage = preload('image-path');
preloadImage.then(function() {
// imagem carregou
});
preloadImage.catch(function() {
// deu erro no carregamento
});
.then()
e .catch()
são os callbacks da promise preload
Agora veja o mesmo exemplo anterior, porém agora com callback
.
var preload = function( url, success, error ) {
var image = new Image();
image.onload = function() {
success( image );
};
image.onerror = function() {
error( Error('Error while loading image: ' + url)) ;
};
image.src = url;
};
E para usar os callbacks
seria algo assim
preload('image-path', function( image ) {
// sucesso ao carregar a imagem
}, function( error ) {
// deu erro ao carregar a imagem
});