使用 promise 模式使用 office.js

Question

目前我已经开始开发一些适用于 Office 2013 的应用程序。为了开发这些应用程序，我使用了 office.js，它旨在与 Excel 工作表一起使用。

大部分 API 如下：

document.getSelectedDataAsync(p1, p2, function(asyncResult)
{
    if (asyncResult.status == 'success')
        // do something with asyncResult.value
    else if (asyncResult.status == 'fail')
        // show asyncResult.error as Error
});

我不喜欢这种异步编程。相反，我更喜欢使用 promises 并编写如下内容：

document.getSelectedDataAsync(p1, p2)
    .done(function(result)
    {
        // do something with result
    })
    .fail(function(error)
    {
        // show error message 
    })

有没有办法通过上面的 Promise 来使用 office.js API？

Answer 1

当然——这个例子使用了the bluebird promise 库。基本上，我们将回调 API 转换为 Promise：

function promisify(fn){ // take a function and return a promise version
     return function(){
          var args = [].slice.call(arguments);
          return new Promise(function(resolve, reject){
               args.push(function(asyncResult){
                    if(asyncResult.status === 'success') resolve(asyncResult.value);
                    else reject(asyncResult.error);
               }); 
               fn.apply(this, args); // call function   
          }.bind(this)); // fixate `this`
     };
}

这会让你做类似的事情：

document.getSelectedDataPromise = promisify(document.getSelectedDataAsync);
document.getSelectedDataPromise(p1, p2).then(function(result){
   // do something with result
}).catch(function(err){
   // handle error
});

Answer 2

解决此问题的最简单形式是将回调替换为可解决承诺的自定义回调。请注意，以下实现使用了 Chrome 中可用的 ES6 承诺：

        function toPromise () {
            var args = Array.prototype.slice.call(arguments);
            var self = this;
            return new Promise(function (reject, resolve) {
                var callback = function () {
                    if (arguments[0] instanceof Error) {
                        return reject.apply(null, arguments);
                    }

                    resolve.apply(arguments);
                };

                args.push(callback);
                self.apply(self, args);
            });
        }

        Function.prototype.toPromise = toPromise;

        document.getSelectedDataAsync.toPromise(p1, p2).then(function () {
            //success
        }).catch(function () {
            //error
        });