你不知道JS:异步(翻译)系列3-1

你不知道JS:异步

第三章:Promises

在第二章,我们指出了采用回调来表达异步和管理并发时的两种主要不足:缺乏序列化和可信度。既然我们对这些问题更熟悉了,是时候将注意力集中到解决这些问题的模式上了。

我们想要处理的第一个问题是控制权反转,信任很难维持,脆弱且容易丢失。

回想一下我们把程序的延续包裹在回调函数中,把回调交给其它方(甚至可能是外部代码),然后祈祷能够正确地调用回调函数。

我们这样做的原因是我们想说,“这个是在当前步骤结束之后,后来发生的”。

但要是我们能够反逆转控制权反转呢?要是能够让第三方返回一个结果,让我们知道它的任务结束时间,然后我们的代码决定接下来该做什么呢?而不是把程序的延续交给第三方。

这一范例称为Promises

随着诸如开发人员和规范制定人员之类的人不顾一切地寻求解决代码/设计中回调地狱错乱问题的方法,Promises将会撼动整个JS世界。事实上,JS/DOM中新加入的API大多数都是建立在Promises上的。那么深入学习Promises可能是个不错的注意,不是吗?

注意: 本章中”立刻(immediately)“一词将会反复提及,通常指某些Promise的解析行为。然而,从本质上来说,”立刻“一词是根据作业队列(Job queue)(见第一章)来说的,不是现在(now)层面上严格同步的意思。

Promise是什么?(What Is a Promise?)

当开发人员学习一种新的技术或者模式时,第一步通常是”给我看代码!“对我们而言,直接进入(译者注:指直接看代码)并学习很自然。

但结果是,只关注API的话,就会丢失一些抽象概念。Promise是这样的一种工具,如果不理解它是做什么的,只是学会使用API的话,使用起来会很痛苦。

因此,在我展示Promise代码之前,我想从概念上完完整整地解释Promise到底是什么。我希望这能够指导你更好地将Promise理论整合到自己的异步流中。

明确这点,让我们看一下两个关于Promise是什么的不同类比。

未来值(Future Value)

假设这个场景:我走到快餐店的柜台,点了一个奶酪汉堡,我递给收银员$1.47的零钱。通过下单和支付,我已经作了一次请求,希望有(奶酪汉堡)返回。我已经开始了一次交易。

但通常,奶酪汉堡并不是立刻就能给我。收银员给了我一个代替奶酪汉堡的东西:一个有订单号的收据。这个订单号是一个IOU(”i owe you
“)的承诺,确保最后我能拿到我的奶酪汉堡。

我拿着我的收据和订单号。我知道它代表着我未来的奶酪汉堡,因此我再也不用担心了--除了我很饿之外!

当我在等的时候,我还可以做其它事,比如给我的朋友发短信说,”嗨,你能和我一起吃午餐吗?我要吃个奶酪汉堡。“

即使还没拿到手,我已经开始推演我的未来奶酪汉堡。我的大脑之所以能这样做是因为它把订单号当成了奶酪汉堡占位符。本质上这个占位符使得值与时间无关。它是未来值

最终,我听到了,”113号!“我很高兴地拿着订单走向柜台。把订单递给收银员后,我拿到了我的奶酪汉堡。

换句话说,一旦我的未来值准备好了,我就可以拿承诺值(value-promise)换真正的值(value)了。

但还可能有另一种结果。他们叫了我的订单号,但是当我去取奶酪汉堡时,收银员很遗憾地告诉我,”很抱歉,我们恰巧卖完了奶酪汉堡“。抛开客户沮丧的场景来看,我们可以看到未来值的一个重要特点:它们既可能预示着成功,也可能预示着失败。

每次我点一个奶酪汉堡,我都知道可能最终我会得到一个,或者很遗憾地听到奶酪汉堡卖完了,不得不另寻其它作为午餐了。

注意: 在代码中,事情并不是如此简单,因为比方来说,订单号可能永远都不会被叫到,此时我们就无限地处在了悬而未决的状态。我们稍后处理这种情形。

现在值和以后值(Values Now and Later)

如果应用到代码中,听起来似乎太抽象了。让我们更具体一点。

然而,在我们以这种方式引入Promise的工作原理前,我们将从已知的代码中--回调--去探究如何处理这些未来值的。

当你写代码来推演一个值的时候,比如对一个number进行数学运算。不论是否意识到,关于那个值,你已经假定了一些重要的东西,即它已经是一个具体的现在值:

var x, y = 2;

console.log( x + y ); // NaN  <-- because `x` isn't set yet

x+y的操作假定xy已经设置好值了。简而言之,我们假定xy已经被解析了(resolved)。

期望+操作符本身能够检测和等到xy都解析完(即准备好,然后去进行+的操作)显然没什么意义。如果不同的语句现在完成,其它的以后完成,这样会使得程序混乱,对吗?

如果一个语句(或者两个都)还没有完成,你该如何推演它们之间的关系呢?如果语句2依赖语句1的完成,只会有两个结果:要么语句1立马完成(right now),一切OK,要么语句1还没完成,进而语句2也将失败。

如果觉得听起来有点耳熟,很好!

让我们回到x+y的数学操作。想象以一种方式说,”将xy相加,如果其中任一个还没准备好,只需等等直至二者都准备好了。尽可能快的将二者相加。“

你的脑袋可能立即跳到了回调。OK,那么...

function add(getX,getY,cb) {
    var x, y;
    getX( function(xVal){
        x = xVal;
        // both are ready?
        if (y != undefined) {
            cb( x + y );    // send along sum
        }
    } );
    getY( function(yVal){
        y = yVal;
        // both are ready?
        if (x != undefined) {
            cb( x + y );    // send along sum
        }
    } );
}

// `fetchX()` and `fetchY()` are sync or async
// functions
add( fetchX, fetchY, function(sum){
    console.log( sum ); // that was easy, huh?
} );

花几分钟来完全领会这段代码的美(或不足)。

不可否认,尽管有点难看,但是这种异步模式中还是有值得注意的地方。

在那段代码中,我们把xy视作未来值,并且表示操作的add(..)并不关心xy是否都立刻准备好了。换句话说,它统一了现在以后,如此我们就可以依赖add(..)操作生成的一个可预测的结果。

通过使用时序一致的add(..)---现在以后的行为都保持一致--使得异步代码更容易推演了。

更通俗一点来说:为了统一处理现在以后,我们把它们都变成了以后。所有的操作都变成异步的了。

当然,这种简单的基于回调不是太令人满意。推演未来值而不需要担心时间维度,即值是否可用,对于这一好处而言,这只是一小步。

承诺值(Promise Value)

本章中,我们肯定会探讨Promise的更多细节--所以,如果有点困惑,别担心--但让我们简单看看如何采用Promise来实现x+y的操作:

function add(xPromise,yPromise) {
    // `Promise.all([ .. ])` takes an array of promises,
    // and returns a new promise that waits on them
    // all to finish
    return Promise.all( [xPromise, yPromise] )

    // when that promise is resolved, let's take the
    // received `X` and `Y` values and add them together.
    .then( function(values){
        // `values` is an array of the messages from the
        // previously resolved promises
        return values[0] + values[1];
    } );
}

// `fetchX()` and `fetchY()` return promises for
// their respective values, which may be ready
// *now* or *later*.
add( fetchX(), fetchY() )

// we get a promise back for the sum of those
// two numbers.
// now we chain-call `then(..)` to wait for the
// resolution of that returned promise.
.then( function(sum){
    console.log( sum ); // that was easier!
} );

这段代码中有两层Promise。

fetchX()fetchY()是直接调用的,返回值(promises!)传入add(..)。这些promise代表的潜在值可能是现在或者以后准备好,但每个promise统一了这一行为。我们以跟时间无关的方式推演(reason about)xy。他们是未来值

第二层是add(..)创建并返回的promise(通过Promise.all([ .. ])),在此通过调用then(..)等待。当add(..)操作完成后,sum未来值就准备好了,之后我们就可以输出它了。我们隐藏了add(..)中等待xy未来值的内部逻辑。

注意:add(..)内部,Promise.all([ .. ])创建了一个promise(等待promiseXpromiseY解析)。.then(..)的链式调用创建了一个promise,return values[0] + values[1]立即得到解析(相加的结果)。因此,add(..)调用之后的链式then(..)调用--代码末尾--实际上是对返回的第二个promise进行操作,而不是对Promise.all([ .. ])创建的第一个。另外,尽管我们没有对第二个then(..)进行链式操作,它其实也生成了一个promise。这种Promise的链式调用会在本章后面作更详尽的说明。

就像奶酪汉堡订单一样,一个Promise的解析结果可能不是成功(fulfillment)而是失败(rejection)的。不像一个成功的promise,其值总是程序化的(programmatic,译者注:指通过程序设定),一个失败值--通常称为“失败原因”--既可通过程序逻辑直接设定,又可由隐式的运行异常导致。

通过Promise,then(..)调用实际能够接受两个函数,一个用作成功(fulfillment),第二个用作失败(rejection):

add( fetchX(), fetchY() )
.then(
    // fullfillment handler
    function(sum) {
        console.log( sum );
    },
    // rejection handler
    function(err) {
        console.error( err ); // bummer!
    }
);

如果获取x或者y出错,或者在相加过程中有什么出错了,则add(..)返回的promise被置为失败状态,传入then(..)的第二个回调错误处理函数将接受promise返回的失败值。

因为Promise从外面封装了跟时间无关的状态--等待潜在值的成功或失败--Promise本身是跟时间无关的,因此Promise可以以可预测的方式组织(组合)起来,不管时间或结果。

此外,一旦Promise解析了,其状态永远不变--自那一时刻起,变成了不可更改的值--可以按需多次监听。

注意: 因为Promise一旦解析,就无法从外面更改其状态了,这样把值传递给第三方就很安全,因为无法无意或恶意地修改它。尤其是当有多个当事方监听这一个Promise的解析结果时更是如此。一方无法影响另一方对Promise解析的监听。不可变性听起来似乎像一个学术课题,但它其实是Promise设计中十分重要的方面之一,不能随意忽略。

那是理解Promise所需的最强大和最重要的概念之一。有一定实践经验后,你也能通过难看的回调组合来专门实现同样的效果,但那并不是一个真正有效的策略,尤其是你必须一次又一次地这么做。

Promise是一种很容易封装和构成未来值的可重复性机制。

完成事件(Completion Event)

正如我们刚刚看到的,一个Promise的行为就像一个未来值。但还可以采用另一种方式来思考Promise:在异步任务的两步或多步中--一个时序的this-then-that--作为一种流控制机制。

假设调用函数foo(..)来执行某个任务。我们不知道任何细节,也不关心。可能是立即完成的,也可能花一些时间。

我们只需简单地知道foo(..)什么时候完成,以便我们能够转到下一个任务中去。换句话说,我们想要通过某种方式来通知我们foo(..)已经完成了,以便于继续做其它事。

在传统JS中,如果你需要监听某个通知(notification),你可能会想到事件。因此,我们可以重构通知需求为需要监听foo(..)发出的完成(或者继续)事件。

注意: 称之为“完成事件”还是“继续事件”取决于你自己。关注点更应该放在foo(..)发生了什么或者foo(..)后会发生什么。这两个角度都是准确和有用的。事件通知告诉我们foo(..)已经完成了,同样也可以说是能够进行下一步了。事件通知时调用的传入的回调函数本身就是我们之前提到的延续(continuation)。因为完成事件更关注于foo(..),此时我们也更关注于它。在本篇其余部分,会倾向于采用完成事件

采用回调函数,“通知”就是任务(foo(..))运行的回调。但采用Promise时,我们转变一下关系,希望我们可以从foo(..)中监听事件,当被通知的时候,进行相应的处理。

首先,考虑如下伪代码:

foo(x) {
    // start doing something that could take a while
}

foo( 42 )

on (foo "completion") {
    // now we can do the next step!
}

on (foo "error") {
    // oops, something went wrong in `foo(..)`
}

我们调用foo(..),然后设置了两个事件监听器,一个监听"completion"事件,一个监听"error"事件--foo(..)调用的两个可能的结果。本质上,foo(..)并不知道调用代码已经订阅了这些事件,很好的实现了关注点分离。

很不幸的是,这种代码需要JS环境的一些“魔法”,但并不存在(并且可能有点不切实际)。以下是我们在JS中以更自然的方式实现的代码:

function foo(x) {
    // start doing something that could take a while

    // make a `listener` event notification
    // capability to return

    return listener;
}

var evt = foo( 42 );

evt.on( "completion", function(){
    // now we can do the next step!
} );

evt.on( "failure", function(err){
    // oops, something went wrong in `foo(..)`
} );

foo(..)显式地创建了事件订阅功能用作返回,然后调用代码接收它并
针对它注册了两个事件处理函数。

很明显,这是从正常的回调导向的代码反转(控制权),也是特意这么做的。foo(..)返回一个称之为evt的事件功能,用它来接收回调函数。

但是如果你回想一下第二章,回调函数本身代表控制权反转(inversion of control)。因此,反转回调模式通常称之为反转的反转(inversion of inversion),或者不反转控制权(uninversion of control)--在我们需要以它为主的地方恢复调用代码的控制权。

这样做的一大好处就是代码的多个独立部分可以获得事件监听能力,当foo(..)完成的时候,它们可以独立地接到通知并进行后续步骤:

var evt = foo( 42 );

// let `bar(..)` listen to `foo(..)`'s completion
bar( evt );

// also, let `baz(..)` listen to `foo(..)`'s completion
baz( evt );

不反转控制权(Uninversion of control)能够实现更好的关注点分离,bar(..)baz(..)不需要关心foo(..)是如何调用的。同样的,foo(..)也不需要知道或者关心bar(..)baz(..)的存在或者foo(..)完成时bar(..)baz(..)正等着被通知。

本质上来说,这个evt对象是不同关注点之间的一个中立的第三方协商。

Promise “事件”(Promise "Events")

现在,你可能猜想,evt事件监听能力是对Promise的一个模拟。

在基于Promise的方式中,之前的代码会让foo(..)生成并返回一个Promise实例,那个promise之后会被传入bar(..)baz(..)

注意: 我们监听的Promise解析“事件”并不是严格意义上的事件(尽管某些地方看起来像事件的行为),并且通常也不称为"completion"或者"error"。反而,我们采用then(..)来注册一个then(..)事件。或者更准确一点,then(..)注册了"fulfillment"和/或"rejection"事件,尽管我们在代码中无法明确地看到这些东西。

考虑如下代码:

function foo(x) {
    // start doing something that could take a while

    // construct and return a promise
    return new Promise( function(resolve,reject){
        // eventually, call `resolve(..)` or `reject(..)`,
        // which are the resolution callbacks for
        // the promise.
    } );
}

var p = foo( 42 );

bar( p );

baz( p );

注意: 采用new Promise( function(..){ .. } )的这种模式通常称为“暴露构造函数(revealing constructor)”(译者注:指Promise构造函数暴露了内部的功能,但只针对构造promise对象的代码)。传入的函数立即执行(不是像传入then(..)中的回调函数异步推迟执行的),该函数接收两个参数,此处我们命名为resolvereject。这两个是promise的解析函数。resolve(..)通常标志着成功(fulfillment),reject(..)通常标志着失败(rejection)。

你可能在猜想bar(..)baz(..)的内部是什么样子:

function bar(fooPromise) {
    // listen for `foo(..)` to complete
    fooPromise.then(
        function(){
            // `foo(..)` has now finished, so
            // do `bar(..)`'s task
        },
        function(){
            // oops, something went wrong in `foo(..)`
        }
    );
}

// ditto for `baz(..)`

Promise解析并不一定像我们检查Promise并作为未来值时一样,需要随之传送一则信息。它可以简单地用作流控制信号,正如前段代码中用到的一样。

另一种实现方法是:

function bar() {
    // `foo(..)` has definitely finished, so
    // do `bar(..)`'s task
}

function oopsBar() {
    // oops, something went wrong in `foo(..)`,
    // so `bar(..)` didn't run
}

// ditto for `baz()` and `oopsBaz()`

var p = foo( 42 );

p.then( bar, oopsBar );

p.then( baz, oopsBaz );

注意: 如果你之前已经看过基于Promise的代码,你可能认为最后两行代码可以采用链式方式写作p.then( .. ).then( .. ),而不是p.then(..); p.then(..)。注意,结果完全不同。现在看起来,差异还不是很明显,但它其实是一种不同于迄今为止我们见过的异步模式:分离/分叉(splitting/forking)。别担心!后面我们会讲。

我们用promise来控制bar(..)baz(..)何时执行,而不是把p promise传入到bar(..)baz(..)中。主要的差异在于错误处理。

在第一段代码中,不论foo(..)成功还是失败,bar(..)都会调用,如果被通知到foo(..)失败了,由bar(..)处理自己的回退逻辑。很明显,baz(..)也是一样。

在第二段代码中,只在foo(..)成功的时候调用bar(..),否则调用oopsBar(..)baz(..)也是一样。

本质上来说,没有哪一个是更恰当的。很多情况下,一个要比另一个更好。

无论哪一种情形,foo(..)返回的promise p都是用来控制接下来干什么。

此外,这两段代码在最后都对同一个promise p调用了两次 then(..),是为了提前说明一点,即Promise(一旦解析)会永远保持同样的解析结果(fulfillment或rejection)不变,可以随后按需任意监听多次。

无论何时,一旦p解析了,下一步总是一样的,不论现在还是以后

Thenable 鸭子类型(Thenable Duck Typing)

在Promise领域中,一个重要的细节是如何判断某个值是否是一个真正的Promise。或者更直接一点,它是一个和Promise行为类似的值吗?

鉴于Promise是通过new Promise(..)语法构建的,你可能认为p instanceof Promise是一个可以接受的检查。但不幸的是,有一万种理由来证明这完全不够。

主要地,你可能从另一个浏览器窗口(iframe等)接收一个Promise,它可能有一个自己的Promise,不同于当前窗口/frame,此时,采用类型检查(即p instanceof Promise)无法识别Promise实例。

此外,库或者框架可能选择提供自己的Promise,而不是采用原生的ES6 Promise实现。事实上,你可能一直在没有Promise的旧浏览器上通过库使用Promise。

当我们在本章后面讨论Promise解析过程的时候,一个non-genuine-but-Promise-like(不是真正的但是像Promise)的值仍然能够识别和理解是很重要的,其原因会变得更明显。但目前,只记住我的话,这是谜团中很重要的一部分。

同样的,识别一个Promise(或者一个表现得像Promise)的方法是定义一个称为"thenable"的东西,它是指任何一个有then(..)方法的对象或者函数。假定任何此类的值是一个Promise-conforming thenable(符合Promise的thenable)。

假定一个值的“类型”是基于其形状(存在什么属性),通常这种“类型检查”称为“鸭子类型”--“如果看起来像鸭子,叫起来也像鸭子,那一定就是鸭子”。因此thenable的鸭子类型检查大概就是这样:

if (
    p !== null &&
    (
        typeof p === "object" ||
        typeof p === "function"
    ) &&
    typeof p.then === "function"
) {
    // assume it's a thenable!
}
else {
    // not a thenable
}

Yuck(一脸嫌弃的眼神)!撇开这种难看的实现逻辑不谈(很多地方都采用这种方法),有些更深层次和更麻烦的东西还在后头。

如果你想用任一个恰巧有then(..)函数的对象/函数来fulfill一个Promise(译者注:指将Promise置为成功状态),但你并不想将它当做一个Promise/thenable,很不走运,因为它会被自动识别为thenable并且采用一些特殊的规则(见本章后面)。

如果是在你没意识到它有一个then(..)方法时,更是如此。比如:

var o = { then: function(){} };

// make `v` be `[[Prototype]]`-linked to `o`
var v = Object.create( o );

v.someStuff = "cool";
v.otherStuff = "not so cool";

v.hasOwnProperty( "then" );     // false

v看起来一点也不像一个Promise或者thenable。它只是个有些属性的普通对象。你可能只是想将它和其它普通对象一样传递出去。

但你不知道的是,v也是[[Prototype]]链于另一个对象o,而o恰巧有一个then(..)方法。因此,thenable鸭子类型检查会认为v是一个thenable。呃。

甚至不需要像下面直接这样做:

Object.prototype.then = function(){};
Array.prototype.then = function(){};

var v1 = { hello: "world" };
var v2 = [ "Hello", "World" ];

v1v2都会被假定为thenable。你无法控制或者预测哪些代码有意或者无意地在Object.prototypeArray.prototype或者其它原生原型上添加了then(..)方法。如果指定的函数并没有调用任一个参数(译者注:指then(..)方法中的两个参数,一个是resolve,一个是reject)作为回调。那么任一个解析该值的Promise将会永远静默挂起!疯狂吧。

听起来不可思议或者不可能?也许吧。

但是请记住,在ES6之前,有几个知名的非Promise的库已经存在于社区了,并且恰巧其中有then(..)方法。其中一些库选择重新命名他们的方法来避免冲突(糟透了!)。其他的只是简单地降级到“与基于Promise的编程不兼容”的状态来应对他们无力改变使其不受影响这一局面。

标准决定劫持之前非保留的--并且听起来完全通用的--then属性名,这意味着,任何值(或者其代理)在过去、现在以及将来,都不能有then(..)方法出现,不论是有意的还是无意的,否则在Promise系统中,该值会被误认为thenable,进而很可能引起bug,不易追踪。

警告: 在Promise识别中,我不想以thenable的鸭子类型检查结束。还可以有其它选项,比如“品牌化(branding)”或者“反品牌化(anti-branding)”;似乎我们选择了最坏的一种折衷。但情况并非一团糟。thenable鸭子类型也是有用的,之后我们会看到。记住,如果把不是Promise的东西错误地识别为Promise,那样鸭子类型检查就会很危险。

Promise信任问题(Promise Trust)

我们已经举了两个有力的例子(译者注:即作为未来值和完成事件),用来从不同方面解释Promise能为我们的异步代码做些什么。但如果我们止步于此,我们会错过Promise模式建立起来的一个最重要的特性:信任。

尽管我们已经在代码中很清楚地展开探究了未来值完成事件,我们还不是很清楚Promise是如何设计的,能够解决我们在第二章“信任问题”一节中提出的所有控制权反转信任问题。只要稍加深究,我们就能在异步编程时重拾第二章中失去的信心!

让我们回顾一下只采用回调编程的信任问题。当传递一个回调给utilityfoo(..),可能:

  • 太早调用回调
  • 太晚调用回调(或者从不调用)
  • 调用太多或者太少
  • 无法传递任何必要的环境/参数
  • 掩盖可能发生的任何错误/异常

Promise的诸多特性就是针对这些问题提供了有用的,经得起考验的答案。

太早调用(Calling Too Early)

这个问题主要在于代码是否会引起像Zalgo效应(见第二章),即一些任务有时是同步完成的,有时是异步完成的,这样会导致竞态。

Promise从定义上来说就不会受此影响。因为即使是一个立即的fulfilled Promise(比如new Promise(function(resolve){ resolve(42); }))也无法同步监听到。

也就是说,当你在一个Promise上调用then(..)方法时,即使Promise已经解析了,你提供给then(..)的回调函数总是异步执行的(要想知道更多,参考第一章“作业”一节)。

再也不需要插入setTimeout(..,0)的hack了,Promise自动阻止了Zalgo。

太晚调用(Calling Too Late)

与前一点类似,当Promise创建时调用resolve(..)或者reject(..),Promise then(..)注册的监听回调是自动调度的。这些调度的回调函数会在下一个异步时刻触发(详见第一章中的“作业”)。

同步监听是不可能的,因此以这种方式运行的一串同步任务“推迟”(从效果上来说)另一个回调的执行是不可能的。也就是说,当一个Promise解析完,所有注册在then(..)上的回调函数都会在下一个异步窗口(再次,见第一章的“作业”)按序立即(immediately)调用,并且任一个回调内部发生的东西不会影响/推迟其它回调的执行。

例如:

p.then( function(){
    p.then( function(){
        console.log( "C" );
    } );
    console.log( "A" );
} );
p.then( function(){
    console.log( "B" );
} );
// A B C

根据Promise定义的运行原理,此处"C"无法中断并领先"B"

Promise调度的怪癖(Promise Scheduling Quirks)

然而,有一点必须要注意,在相对顺序无法可靠预测时,两个不同Promise的链式回调的调度有许多细节需要考虑。

如果两个promise p1p2已经解析完了,那么p1.then(..); p2.then(..)最终p1的回调会在p2的回调之前被调用。但是有一些不可思议的情况,比如下面这个:

var p3 = new Promise( function(resolve,reject){
    resolve( "B" );
} );

var p1 = new Promise( function(resolve,reject){
    resolve( p3 );
} );

var p2 = new Promise( function(resolve,reject){
    resolve( "A" );
} );

p1.then( function(v){
    console.log( v );
} );

p2.then( function(v){
    console.log( v );
} );

// A B  <-- not  B A  as you might expect

对此,我们之后会细讲,但如你所见,p1并不是立即值解析的,而是另一个promise p3p3解析的是值B。这一特定行为是把p3打开传入到p1中,但是异步的,因此在异步作业队列(见第一章)中,p1的回调是在p2回调后面的。

为了避免这种微妙的噩梦,你绝不要依赖跨Promise来实现回调的排序/调度。实际上,一个好的方法是在多个回调的顺序很重要的时候,不要像这样编写代码。尽可能避免。

从不调用回调(Never Calling the Callback)

这是很常见的一个问题。可以用Promise采用多种方式解决。

首先。没有什么(甚至是一个JS错误)能够阻止Promise通知你它的解析结果(如果已经解析完了)。如果你为Promise同时注册了fulfillment和rejection回调,待Promise解析完成后,总有一个会被调用。

当然,如果回调函数本身有JS错误,你可能看不到期望的结果,但回调函数已经执行过了。我们接下来会讲在回调中如何接收错误,因为即使是那些也不会被掩盖。

但要是Promise本身永不解析呢?即使是那种情况,Promise也提供了解决方法,用一种更高级的抽象,称为“竞争(race)”:

// a utility for timing out a Promise
function timeoutPromise(delay) {
    return new Promise( function(resolve,reject){
        setTimeout( function(){
            reject( "Timeout!" );
        }, delay );
    } );
}

// setup a timeout for `foo()`
Promise.race( [
    foo(),                  // attempt `foo()`
    timeoutPromise( 3000 )  // give it 3 seconds
] )
.then(
    function(){
        // `foo(..)` fulfilled in time!
    },
    function(err){
        // either `foo()` rejected, or it just
        // didn't finish in time, so inspect
        // `err` to know which
    }
);

这种Promise超时模式还有更多细节值得探究,之后会讨论。

重要的是,我们可以确保有一个信号作为foo()的结果,防止我们的程序被无限地挂起。

调用太少或太多次(Calling Too Few or Too Many Times)

从定义上看,就是回调被调用的次数。“太少”就是零调用,和我们之前说过的“从不”一个意思。

“太多”很容易解释,Promise被定义为只能解析一次。如果由于某些原因,Promise的创建代码试图多次调用resolve(..)或者reject(..),或者两个都调用,Promise只会接受第一个解析,并静默地忽略之后的尝试。

因为Promise只能解析一次,任一个then(..)注册的回调也只能调用一次(对每个而言)。

当然,如果你不止一次地注册同一个回调,(例如,p.then(f); p.then(f);),则注册多少次就执行多少次。响应函数只能调用一次并不能阻止你搬起石头砸自己的脚。

无法传递任何参数/环境(Failing to Pass Along Any Parameters/Environment)

Promise最多只有一个解析值(fulfillment或者rejection)。

如果你不显式地解析一个值,就会像传统JS一样,为undefined。但是一旦有值,则总会传到所有注册(fulfillment或者rejection)的回调中去,不论是现在的还是将来的。

记住:如果调用resolve(..)或者reject(..)时的参数有多个,除了第一个参数,所有后面的参数都会被默认忽略。看起来似乎有点违背我们之前描述的保证,其实并不是,因为这是对Promise机制的一个无效应用。其它一些无效的API应用(比如多次调用resolve(..))也是同样受到保护的,因此Promise的行为是一致的。

如果你想传入多个值,必须把它们包在另一个你传入的单值里,比如一个array或者一个object

至于环境,JS函数中总是保存着定义时的作用域闭包,因此,它们当然
可以访问任何你提供的环境状态。当然,只有回调的设计中也是这样的,因此这并不是Promise带来的额外好处--但能够保证我们可以依赖它。

掩盖任何错误/异常(Swallowing Any Errors/Exceptions)

从基本意义上来说,这是之前观点的重述。如果用一个原因(reason)(即错误信息)来将一个Promise置为失败状态,这个值(译者注:指reason)就会被传到rejection回调中去。

但此处还有更大的东西。在创建Promise过程中的任一时刻,或者在监听解析结果的时候,如果发生了JS异常错误,比如TypeError或者ReferenceError,异常会被捕获,并且会强制Promise变成失败状态。

比如:

var p = new Promise( function(resolve,reject){
    foo.bar();  // `foo` is not defined, so error!
    resolve( 42 );  // never gets here :(
} );

p.then(
    function fulfilled(){
        // never gets here :(
    },
    function rejected(err){
        // `err` will be a `TypeError` exception object
        // from the `foo.bar()` line.
    }
);

发生自foo.bar()的JS异常变成了一个Promise rejection,你可以捕获它并进行响应。

这是个重要的细节,因为能够有效地解决另一个潜在的Zalgo情形,即错误可能创建一个同步的响应而非错误(nonerrors)则是异步的。Promise甚至把JS异常也转为异步的了,因此能够极大地减少竞态的发生。

但如果Promise被置为成功状态(fulfilled)了,但是在监听过程中(在一个then(..)注册回调中)发生了JS异常,会发生什么呢?即使能捕获这些异常,在更深入了解之前,你可能会对处理异常的方式感到惊讶。

var p = new Promise( function(resolve,reject){
    resolve( 42 );
} );

p.then(
    function fulfilled(msg){
        foo.bar();
        console.log( msg ); // never gets here :(
    },
    function rejected(err){
        // never gets here either :(
    }
);

等等,似乎foo.bar()的异常被掩盖了。别担心,并没有。但是更深层次的东西出问题了,即我们无法监听这个异常了。p.then(..)本身返回了另一个promise,这个promise会因TypeError异常而被置为失败状态(rejected)。

为什么没有直接调用已经定义好的错误处理函数呢?表面上看起来似乎很合逻辑。但会违背一条重要原则,即一旦解析,Promise就是不可改变的p已经由值42置为成功状态,因此之后不可能仅仅因为监听p的解析中有一个异常而改为失败状态。

除了违背这一原则外,这样的行为也可能造成很大破坏,假设在promise p上有许多then(..)注册回调,因为有些会调用,而有些不会,这样会导致原因不清不楚。

可信赖的Promise?(Trustable Promise?)

基于Promise模式建立信任还有最后一个细节。

毫无疑问,你已经注意到Promise并没有摆脱回调。它们只是改变了回调传入的地方。我们从foo(..)中得到一个东西(看起来是一个真正的Promise),然后把回调传入其中,而不是把回调传入到foo(..)中。

但为什么这比只使用回调更值得信赖呢?我们如何确保得到的东西真的是可信赖的Promise呢?我们所相信的(仅仅因为我们已经相信它了)是不是基本上都是空中楼阁?

关于Promise,一个很重要但经常被忽略的细节是,Promise对这个问题也有一个解决方案。即包含在原生ES6 Promise中的Promise.resolve(..)

如果你向Promise.resolve(..)中传入一个立即值、非Promise值、非thenable值,你会得到一个以该值将状态置为成功的promise。换句话说,以下两个promise p1p2行为基本上一致:

var p1 = new Promise( function(resolve,reject){
    resolve( 42 );
} );

var p2 = Promise.resolve( 42 );

但是如果你向Promise.resolve(..)中传入一个真正的Promise,你只会得到同一个promise:

var p1 = Promise.resolve( 42 );

var p2 = Promise.resolve( p1 );

p1 === p2; // true

更重要的是,如果你向Promise.resolve(..)中传入一个非Promise的thenable值。它会试图拆析(unwrap)这个值,并且会一直持续直至抽取到一个具体的non-Promise-like值。

回想一下我们之前讨论的thenable?

如下:

var p = {
    then: function(cb) {
        cb( 42 );
    }
};

// this works OK, but only by good fortune
p
.then(
    function fulfilled(val){
        console.log( val ); // 42
    },
    function rejected(err){
        // never gets here
    }
);

这个p是个thenable。但不是一个真正的Promise。幸运的是,这是合理的,因为绝大多数都是这样的。但要是你得到的是这样的呢:

var p = {
    then: function(cb,errcb) {
        cb( 42 );
        errcb( "evil laugh" );
    }
};

p
.then(
    function fulfilled(val){
        console.log( val ); // 42
    },
    function rejected(err){
        // oops, shouldn't have run(本不该运行的啊!)
        console.log( err ); // evil laugh
    }
);

这个p是一个thenable,但并没有如promise表现得那么好。它是恶意的吗?或者仅仅是忘记了Promise是如何运行的?说实话,没关系。无论哪一种情形(即以上两个例子)都是不可信任的。

然而,我们可以将这两个版本的p传入到Promise.resolve(..)中,最终会得到我们期望的标准、安全的结果。

Promise.resolve( p )
.then(
    function fulfilled(val){
        console.log( val ); // 42
    },
    function rejected(err){
        // never gets here
    }
);

Promise.resolve(..)会接收任何thenable,然后将其拆析(unwrap)直至获得一个非thenable值。但是从Promise.resolve(..),你会得到一个真正的promise,一个你可以信赖的promise。如果你传入的已经是个真正的promise,只会原样返回,因此,通过Promise.resolve(..)过滤来获取信任一点坏处也没有。

因此,假设我们正在调用foo(..)utility,我们不确定它的返回值是否是正常的Promise,但我们知道它至少是个thenable。Promise.resolve(..)会给我们一个值得信赖的Promise包装用作链式调用:

// don't just do this:
foo( 42 )
.then( function(v){
    console.log( v );
} );

// instead, do this:
Promise.resolve( foo( 42 ) )
.then( function(v){
    console.log( v );
} );

注意: 通过Promise.resolve(..)包装任何函数返回值(thenable或者其它)的另一个好处是,很容易将一个函数调用标准化为一个表现良好的异步任务。如果foo(42)有时返回一个立即值,有时返回一个Promise,Promise.resolve( foo(42) )能够确保它总是一个Promise返回值。避免Zalgo让代码更好。

信任建立(Trust Built)

希望前面的讨论完全“resolve”(双关,既指解决,又指Promise中的resolve)你心中的疑惑,即为什么Promise是可信赖的,更重要的是,为什么在构造鲁棒、可维护的软件时,信任是那么重要。

在JS中,你能在没有信任的情况下编写异步代码吗?当然,你可以。我们JS开发者已经只用回调异步编程快二十年了。

你对你所建立之上的机制信任到什么程度,才能够使之可预测和可依赖,一旦你开始质疑,你就会渐渐意识到回调的信任根基并不十分牢固。

Promise是以可信赖语义增强回调的一种模式,因此其行为更合理,更值得信赖。通过反逆转回调的控制权反转,我们采用专门用来健全异步的可信赖系统(Promise)来进行控制。

链式流(Chain Flow)

我们已经暗示过好多次了,Promise不仅仅是一个单步的this-then-that操作。当然,那是一个构建块,但是结果表明,我们可以串起多个Promise来代表一系列的异步步骤。

成功的关键在于Promise的两个内在的行为:

  • 每次对Promise调用then(..)时,都会创建并返回一个新的Promise,我们可以对其进行链式操作。
  • then(..)调用的fulfillment回调(第一个参数)返回的任何值都会自动设置为链式Promise(见第一点)的fulfillment。

让我们首先说明一下是什么意思,之后我们会明白Promise是如何帮助我们创建异步序列控制流的。考虑如下代码:

var p = Promise.resolve( 21 );

var p2 = p.then( function(v){
    console.log( v );   // 21

    // fulfill `p2` with value `42`
    return v * 2;
} );

// chain off `p2`
p2.then( function(v){
    console.log( v );   // 42
} );

通过返回v * 2(即42),我们将第一个then(..)调用生成的promise p2置成成功状态,当调用p2then(..)时,它从return v * 2语句接收fulfillment。当然,p2.then(..)创建了另一个promise,我们可将它存储在p3变量中。

但是必须创建中间变量p2(或者p3等)有点恼人。值得庆幸的是,我们可以简单地将它们串联起来:

var p = Promise.resolve( 21 );

p
.then( function(v){
    console.log( v );   // 21

    // fulfill the chained promise with value `42`
    return v * 2;
} )
// here's the chained promise
.then( function(v){
    console.log( v );   // 42
} );

那么现在第一个then(..)就是异步序列中的第一步,第二个then(..)就是第二步。只要我们需要,就可以一直往下扩展。只要通过自动生成的Promise,链接到前一个then(..)上就行了。

但此处似乎少了什么东西。要是我们想让步骤2等待步骤1作一些异步操作呢?我们采用的是立即的(immediately)return语句,会立刻将链式的promise置为成功状态。

回想一下,当你传给它的是一个Promise或者thenable而不是一个最终值时(译者注:此处指立即值),Promise.resolve(..)是如何运行的,这是使得一个Promise序列在每一步都具有异步能力的关键。Promise.resolve(..)会直接返回接收的真正Promise,或者拆析(unwrap)接收的thenable的值--并且在拆析(unwrap)thenable时会一直递归下去。

如果你从fulfillment(或者rejection)的回调函数中return一个thenable或者Promise时,也会发生同样的拆解。

考虑如下:

var p = Promise.resolve( 21 );

p.then( function(v){
    console.log( v );   // 21

    // create a promise and return it
    return new Promise( function(resolve,reject){
        // fulfill with value `42`
        resolve( v * 2 );
    } );
} )
.then( function(v){
    console.log( v );   // 42
} );

即使我们将42包装到了返回的promise中,它仍然会被拆析(unwrap)并最终作为链式promise的解析项,以便第二个then(..)仍然接收到42。如果我们将异步引入到那个包装promise中,一切照旧:

var p = Promise.resolve( 21 );

p.then( function(v){
    console.log( v );   // 21

    // create a promise to return
    return new Promise( function(resolve,reject){
        // introduce asynchrony!
        setTimeout( function(){
            // fulfill with value `42`
            resolve( v * 2 );
        }, 100 );
    } );
} )
.then( function(v){
    // runs after the 100ms delay in the previous step
    console.log( v );   // 42
} );

好强大!现在我们可以按需构建任意多的异步步骤,并且每一步都可以按需推迟(或不推迟)下一步的执行。

当然,这些例子中步骤之间传递的值是可选的。如果你不返回一个显式的值,则会假定有个隐式的undefined,并且promise还是以同样的方式串起来。每个Promise的解析项只是进行到下一步的信号。

为了更进一步说明链式,让我们创建一个通用utility,用来生成延时Promise,使之能够多步复用:

function delay(time) {
    return new Promise( function(resolve,reject){
        setTimeout( resolve, time );
    } );
}

delay( 100 ) // step 1
.then( function STEP2(){
    console.log( "step 2 (after 100ms)" );
    return delay( 200 );
} )
.then( function STEP3(){
    console.log( "step 3 (after another 200ms)" );
} )
.then( function STEP4(){
    console.log( "step 4 (next Job)" );
    return delay( 50 );
} )
.then( function STEP5(){
    console.log( "step 5 (after another 50ms)" );
} )
...

调用delay(200)会创建一个200ms后fulfill的promise,然后从第一个then(..)的fulfillment回调中返回,这会让第二个then(..)的promise等那个200ms的promise。

注意: 如上所述,在交替过程中有两个promise:200ms延时的promise和来自第二个then(..)所链的promise(译者注:指第一个then(..)生成的promise)。但是你从心理上觉得将这两个promise整合起来会更容易理解,Promise机制自动为你整合状态。从那个角度讲,你可以认为return delay(200)创建了一个promise并替代了早先返回的链式promise。

然而,老实说,没有信息传递的序列延时并不是一个特别有用的Promise流控制的例子。让我们看一个更有实际意义的场景。

让我们考虑Ajax请求,而不是定时器:

// assume an `ajax( {url}, {callback} )` utility

// Promise-aware ajax
function request(url) {
    return new Promise( function(resolve,reject){
        // the `ajax(..)` callback should be our
        // promise's `resolve(..)` function
        ajax( url, resolve );
    } );
}

我们首先定义了一个request(..)utility,用来构建一个promise代表ajax(..)调用的完成:

request( "http://some.url.1/" )
.then( function(response1){
    return request( "http://some.url.2/?v=" + response1 );
} )
.then( function(response2){
    console.log( response2 );
} );

注意: 开发者常遇到的一种情形是,他们想采用一些本身不支持Promise(Promise-enabled)的第三方utility(比如此处的ajax(..),它需要一个回调函数)来实现类Promise(Promise-aware)的异步流控制。尽管原生的ES6 Promise机制无法自动为我们提供这种模式,但是所有的Promise库会提供。通常称这个过程为“提升(lifting)”或者“promise化(promisifying)” 或者其它变体。我们之后会讨论这一技术。

我们通过第一个URL调用request(..)(能返回Promise(Promise-returning))来隐式创建链的第一步,然后用第一个then(..)链接到返回的promise上。

一旦response1返回,我们用那个值来构建第二个URL,作第二次request(..)调用。第二个request(..)返回promise后,异步流中的第三步等待Ajax调用完成。最终,一旦返回值,立即打印response2

我们构建的Promise链不仅仅是一个表示多步异步序列的流控制,还充当了步与步之间传递信息的通道。

要是Promise链中的某一步出错了呢?错误/异常是基于单个Promise的(译者注:指异常发生在生成Promise的每个链中),这意味着可以在链中的任一点捕获这个错误,并且那个捕获在那时充当了“重设”链回到正常操作的角色:

// step 1:
request( "http://some.url.1/" )

// step 2:
.then( function(response1){
    foo.bar(); // undefined, error!

    // never gets here
    return request( "http://some.url.2/?v=" + response1 );
} )

// step 3:
.then(
    function fulfilled(response2){
        // never gets here
    },
    // rejection handler to catch the error
    function rejected(err){
        console.log( err ); // `TypeError` from `foo.bar()` error
        return 42;
    }
)

// step 4:
.then( function(msg){
    console.log( msg );     // 42
} );

当step2中发生错误时,step3中的rejection回调捕获到该异常。如果rejection函数中有返回值(此处代码中为42),则为step4将promise置为成功状态,以便让链回到fulfillment状态。

注意: 正如我们早前讨论的一样,当从一个fulfillment函数中返回一个promise时,它会被拆析(unwrap)并且推迟下一步。这同样也适用于rejection函数,即如果step3返回一个promise而不是return 42,则那个promise会推迟step4。一个then(..)中的fulfillment和rejection回调中的异常都会将下一个(链式)promise立即置为失败状态。

如果你在一个promise上调用then(..),并且你只传了一个fulfillment回调,则会替换为一个假定的rejection处理函数:

var p = new Promise( function(resolve,reject){
    reject( "Oops" );
} );

var p2 = p.then(
    function fulfilled(){
        // never gets here
    }
    // assumed rejection handler, if omitted or
    // any other non-function value passed
    // function(err) {
    //     throw err;
    // }
);

如你所见,假定的rejection处理函数只是简单地重新抛出错误,最终强制p2(链式的promise)以同样的错误原因reject。本质上,这允许错误沿着Promise链继续传播,直至遇到一个显式定义的rejection处理函数。

注意: 关于错误处理,稍后我们会讨论更多细节,因为有些其它微妙的细节需要关注。

如果没向then(..)中传递一个有效的fulfillment处理函数,则同样也会替换为一个默认的处理函数:

var p = Promise.resolve( 42 );

p.then(
    // assumed fulfillment handler, if omitted or
    // any other non-function value passed
    // function(v) {
    //     return v;
    // }
    null,
    function rejected(err){
        // never gets here
    }
);

如你所见,默认的fulfillment处理函数只是简单地将接收到的值传递到下一步(Promise)。

注意: then(null,function(err){ .. })模式--只处理rejection(如果有的话)而让fulfillment通过--有一个快捷的API:catch(function(err){ .. })。我们将在下一节中详尽地讨论catch(..)

让我们简单回顾下Promise支持的链式流控制的固有行为:

  • 对一个Promise调用then(..)会自动生成一个新的Promise并返回。
  • 在fulfillment/rejection处理函数内部,如果返回一个值或者抛出一个异常,则新返回的(链式)Promise会相应地得到解析。
  • 如果fulfillment或者rejection处理函数返回一个Promise,则该Promise会被拆析(unwrap),它的解析结果会成为当前then(..)返回的链式Promise的解析结果。

尽管链式流控制很有用,但最确切地说,这是Promise组成(组合)方式的一个附加好处,而不是主要目的。正如我们多次讨论过的,Promise将异步标准化并且封装了与时间无关的值状态,那才是我们得以用这种有用的方式将它们链在一起的原因。

当然,在处理第二章我们提出的回调混乱问题时,链式的序列化表示(this-then-this-then-this...)是个巨大改善。但是仍然有相当数量的样板(then(..)function(){ .. })需要费力的读完。在下一章,我们将会见到一个明显更好的、采用生成器的序列化流控制表示。

术语:解析,成功,失败(Terminology: Resolve, Fulfill, and Reject)

在更深入学习Promise前,我们需要搞清楚一些有点混淆的术语,“resolve”,“fulfill”和“reject”。首先考虑Promise(..)构造函数:

var p = new Promise( function(X,Y){
    // X() for fulfillment
    // Y() for rejection
} );

如你所见,两个回调函数(此处标为XY)。第一个通常用于将Promise标为fulfilled状态,第二个总是将Promise标为rejected状态。但“通常”是指什么?准确地命名这些参数(译者注:指XY)意味着什么?

最终,只是你的用户代码对引擎有用,标识符名称对引擎而言没任何意义。因此从技术上来说,标识符名称并不重要,foo(..)bar(..)同样可以。但是你所用的词不但影响你如何思考这段代码,而且也影响团队中的其他开发人员。对精心编排的异步代码的错误思考比意大利面条式的回调更糟。

因此,如何称呼它们真的有点重要。

第二个参数很容易确定。几乎所有的文章采用reject(..)作为它的名字,因为这就是它(也是唯一!)做的事,是个非常好的命名选择。我强烈建议你总是使用reject(..)

但是关于第一个参数,就有点模糊不清了,在Promise文献中通常称为resolve(..),那个词很明显和“resolution”相关,即在所有文献中(包括这本书)用来描述给一个Promise设置最终值/状态。我们已经好几次使用"resolve the Promise"来表示fulfill或者reject一个Promise。

但是,如果这个参数看起来似乎是专门用于fulfill Promise,为什么我们不叫它fulfill(..),而叫它resolve(..)更准确呢?为了回答这个问题,我们也来看一下两个Promise API:

var fulfilledPr = Promise.resolve( 42 );

var rejectedPr = Promise.reject( "Oops" );

Promise.resolve(..)创建了一个按所给值解析的Promise。在这个例子中,42是个正常的,非Promise,非thenable的值。因此,以值42创建了fulfilled的promise fulfilledPrPromise.reject("Oops")以原因短语"Oops"创建了一个rejected的promise rejectedPr

现在让我们举例说明一下,如果显式地用在可能导致fulfillment或者rejection的上下文中,为什么“resolve”一词(比如 Promise.resolve(..)中)很清晰并且确实更准确:

var rejectedTh = {
    then: function(resolved,rejected) {
        rejected( "Oops" );
    }
};

var rejectedPr = Promise.resolve( rejectedTh );

正如本章早些时候讨论的那样,Promise.resolve(..)会直接返回接收的真实Promise,或者拆析(unwrap)接收的thenable。如果拆析(unwrap)的thenable显示的是rejected状态,则Promise.resolve(..)事实上返回的是同样的rejected状态。

因此,Promise.resolve(..)是个很好的,准确的API方法名称,因为它实际上既能生成fulfillment,又能生成rejection。

Promise(..)构造函数的第一个回调参数既会拆析(unwrap)一个thenable(与Promise.resolve(..)一致),也可拆析(unwrap)一个真正的Promise:

var rejectedPr = new Promise( function(resolve,reject){
    // resolve this promise with a rejected promise
    resolve( Promise.reject( "Oops" ) );
} );

rejectedPr.then(
    function fulfilled(){
        // never gets here
    },
    function rejected(err){
        console.log( err ); // "Oops"
    }
);

现在应该明白resolve(..)Promise(..)构造函数的第一个回调参数的合适名称了吧。

警告: 前面提到的reject(..)并不会像resolve(..)一样进行拆析。如果你向reject(..)中传入一个Promise/thenable。则该未处理的值将被设为rejection原因短语。随后的rejection处理函数会接收到你传入reject(..)的Promise/thenable,而不是最终拆析的立即值。

现在让我们的注意力回到then(..)中的回调。它们应该称为什么(无论是在文献中还是在代码中)?我建议fulfilled(..)rejected(..)

function fulfilled(msg) {
    console.log( msg );
}

function rejected(err) {
    console.error( err );
}

p.then(
    fulfilled,
    rejected
);

then(..)中的第一个参数,毫无疑问总是fulfillment情况,因此没有 必要使用二义性术语“resolve”。顺便提一下,ES6规范中使用onFulfilled(..)onRejected(..)来标记这两个回调,因此使用这两个术语很准确的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 151,829评论 1 331
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 64,603评论 1 273
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 101,846评论 0 226
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 42,600评论 0 191
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 50,780评论 3 272
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 39,695评论 1 192
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,136评论 2 293
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,862评论 0 182
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,453评论 0 229
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,942评论 2 233
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,347评论 1 242
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,790评论 2 236
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,293评论 3 221
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,839评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,448评论 0 181
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 34,564评论 2 249
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 34,623评论 2 249

推荐阅读更多精彩内容