Como espero uma promessa terminar antes de retornar a variável de uma função?

Ainda estou lutando com promessas, mas fazendo algum progresso graças à comunidade daqui.

Eu tenho uma função JS simples que consulta um banco de dados Parse. Ele deve retornar a matriz de resultados, mas obviamente devido à natureza assíncrona da consulta (daí as promessas), a função retorna antes dos resultados, deixando-me com uma matriz indefinida.

O que preciso fazer para que essa função aguarde o resultado da promessa?

Aqui está o meu código:

function resultsByName(name)
{   
    var Card = Parse.Object.extend("Card");
    var query = new Parse.Query(Card);
    query.equalTo("name", name.toString());

    var resultsArray = [];

    var promise = query.find({
               success: function(results) {
               // results is an array of Parse.Object.
                             console.log(results);
                             //resultsArray = results;
                             return results;
               },

               error: function(error) {
               // error is an instance of Parse.Error.
                             console.log("Error");
               }
    });                           

}

Em vez de retornar um, resultsArrayvocê retorna uma promessa para uma matriz de resultados e, em seguida, thenaquela no site da chamada - isso tem o benefício adicional de o chamador saber que a função está executando E / S assíncrona. A simultaneidade de codificação em JavaScript é baseada nisso - você pode ler esta pergunta para ter uma idéia mais ampla:

function resultsByName(name)
{   
    var Card = Parse.Object.extend("Card");
    var query = new Parse.Query(Card);
    query.equalTo("name", name.toString());

    var resultsArray = [];

    return query.find({});                           

}

// later
resultsByName("Some Name").then(function(results){
    // access results here by chaining to the returned promise
});

Você pode ver mais exemplos de como usar promessas de análise com consultas na postagem do blog do Parse sobre isso .

O que preciso fazer para que essa função aguarde o resultado da promessa?

Use async/await(NÃO faz parte do ECMA6, mas está disponível para Chrome, Edge, Firefox e Safari desde o final de 2017, consulte canIuse )
MDN

    async function waitForPromise() {
        // let result = await any Promise, like:
        let result = await Promise.resolve('this is a sample promise');
    }

Adicionado devido ao comentário: Uma função assíncrona sempre retorna uma promessa e, no TypeScript, seria semelhante a:

    async function waitForPromise(): Promise<string> {
        // let result = await any Promise, like:
        let result = await Promise.resolve('this is a sample promise');
    }

Você não deseja que a função aguarde, pois o JavaScript não deve ser bloqueado. Em vez disso, retorne a promessa no final da função, e a função de chamada poderá usar a promessa para obter a resposta do servidor.

var promise = query.find(); 
return promise; 

//Or return query.find(); 

Você não está realmente usando promessas aqui. O Parse permite usar retornos de chamada ou promessas; sua escolha.

Para usar promessas, faça o seguinte:

query.find().then(function() {
    console.log("success!");
}, function() {
    console.log("error");
});

Agora, para executar coisas após a conclusão da promessa, você pode executá-lo apenas dentro do retorno de chamada da promessa dentro do then() chamada. Até agora, isso seria exatamente o mesmo que retornos de chamada regulares.

Realmente fazer bom uso das promessas é quando você as encadeia, assim:

query.find().then(function() {
    console.log("success!");

    return new Parse.Query(Obj).get("sOmE_oBjEcT");
}, function() {
    console.log("error");
}).then(function() {
    console.log("success on second callback!");
}, function() {
    console.log("error on second callback");
});