sinonjs/sinon

Document how we can control Promises

Open

#1,898 创建于 2018年9月9日

在 GitHub 查看
 (8 评论) (0 反应) (0 负责人)JavaScript (9,548 star) (764 fork)batch import
DocumentationHelp wantedgood first issuehacktoberfestpinned

描述

There have been a couple of longstanding issues and pull requests regarding Promises on the lolex issue tracker.

I am assuming we will probably implement https://github.com/sinonjs/lolex/issues/114 in time, for a totally synchronous way to control Promises, but for it to work fully in true ES2017+ environments using asynchronous/await it requires explicit support from the underlying engine.

Before it's implemented we should document for people how they can control Promises today in "normal" cases. We can't cover all cases (as mentioned above), but we could perhaps make a tutorial to show a possible path. I don't care about pretty in this regard, but results, so if it involves overriding Promise.prototype, installing Bluebird or other non-core Sinon libs that's ok. It's just about covering how to achieve a common desire, like the proxyquire article shows.

I am not totally sure how or what, but something ...

贡献者指南

技术栈
javascript
领域
documentation
议题类型
documentation
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
half day
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
unclear
前置要求
JavaScript Promisesasync/awaitsinon basics
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
55
研究方向
The issue asks for a tutorial on controlling Promises in tests using lolex/sinon, referencing issue #114 for a potential synchronous approach. Research should explore existing documentation in sinon and lolex, and look at the proxyquire article as a model. The tutorial should cover overriding Promise.prototype or using libraries like Bluebird, and provide concrete examples for common scenarios.