.return

.return(any value) -> Promise

.thenReturn(any value) -> Promise

Удобный метод для:

.then(function() {
   return value;
});

в случае, когда value не изменяет своё значение, потому что время его связывания отличается от времени использования замыкания.

Это означает, что value связывается в момент вызова .return, поэтому это не будет работать как ожидается:

function getData() {
    var data;

    return query().then(function(result) {
        data = result;
    }).return(data);
}

потому что data undefined в момент, когда вызывается .return.

Функция, возвращающая полный путь записанного файла:

var Promise = require("bluebird");
var fs = Promise.promisifyAll(require("fs"));
var baseDir = process.argv[2] || ".";

function writeFile(path, contents) {
    var fullpath = require("path").join(baseDir, path);
    return fs.writeFileAsync(fullpath, contents).return(fullpath);
}

writeFile("test.txt", "this is text").then(function(fullPath) {
    console.log("Successfully file at: " + fullPath);
});

Для совместимости с более ранними версиями ECMAScript, псевдоним .thenReturn предоставлен для .return.