{"id":22106972,"url":"https://github.com/ecomfe/redux-managed-thunk","last_synced_at":"2026-03-06T08:32:49.865Z","repository":{"id":57350999,"uuid":"89998568","full_name":"ecomfe/redux-managed-thunk","owner":"ecomfe","description":"A redux-thunk compatible middleware with managed feature to help write more controllable and reusable thunks","archived":false,"fork":false,"pushed_at":"2017-05-16T07:46:57.000Z","size":126,"stargazers_count":20,"open_issues_count":0,"forks_count":1,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-09-03T03:03:58.758Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ecomfe.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-02T06:21:19.000Z","updated_at":"2023-10-10T12:49:24.000Z","dependencies_parsed_at":"2022-09-18T23:03:07.261Z","dependency_job_id":null,"html_url":"https://github.com/ecomfe/redux-managed-thunk","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ecomfe/redux-managed-thunk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomfe%2Fredux-managed-thunk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomfe%2Fredux-managed-thunk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomfe%2Fredux-managed-thunk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomfe%2Fredux-managed-thunk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ecomfe","download_url":"https://codeload.github.com/ecomfe/redux-managed-thunk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ecomfe%2Fredux-managed-thunk/sbom","scorecard":{"id":365662,"data":{"date":"2025-08-11","repo":{"name":"github.com/ecomfe/redux-managed-thunk","commit":"935c1ab170d9e77e50948bfdac80a406776c8293"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/17 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"140 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9","Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25","Warn: Project is vulnerable to: GHSA-8w4h-3cm3-2pm2","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-pp7h-53gx-mx7r","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx","Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw","Warn: Project is vulnerable to: GHSA-wxhq-pm8v-cw75","Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-p28h-cc7q-c4fg","Warn: Project is vulnerable to: GHSA-9vvw-cc9w-f27h","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-hr2v-3952-633q","Warn: Project is vulnerable to: GHSA-h6ch-v84p-w6p9","Warn: Project is vulnerable to: GHSA-vh7m-p724-62c2","Warn: Project is vulnerable to: GHSA-r9p9-mrjm-926w","Warn: Project is vulnerable to: GHSA-434g-2637-qmqr","Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m","Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw","Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p","Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747","Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh","Warn: Project is vulnerable to: GHSA-4gmj-3p3h-gm8h","Warn: Project is vulnerable to: GHSA-6h5x-7c5m-7cr7","Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc","Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx","Warn: Project is vulnerable to: GHSA-qrmc-fj45-qfc2","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-mpcf-4gmh-23w8","Warn: Project is vulnerable to: GHSA-9qj9-36jm-prpv","Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3","Warn: Project is vulnerable to: MAL-2023-462","Warn: Project is vulnerable to: GHSA-xf7w-r453-m56c","Warn: Project is vulnerable to: GHSA-qh2h-chj9-jffq","Warn: Project is vulnerable to: GHSA-q42p-pg8m-cqh6","Warn: Project is vulnerable to: GHSA-w457-6q6x-cgp9","Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f","Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p","Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv","Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8","Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65","Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh","Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44","Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988","Warn: Project is vulnerable to: GHSA-44pw-h2cw-w3vq","Warn: Project is vulnerable to: GHSA-jp4x-w63m-7wgm","Warn: Project is vulnerable to: GHSA-c429-5p7v-vgjp","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-pfq8-rq6v-vf5m","Warn: Project is vulnerable to: GHSA-6x33-pw7p-hmpq","Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-4hpf-3wq7-5rpr","Warn: Project is vulnerable to: GHSA-f522-ffg8-j8r6","Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546","Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-282f-qqgm-c34q","Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq","Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488","Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g","Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695","Warn: Project is vulnerable to: GHSA-fvqr-27wr-82fm","Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574","Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-7px7-7xjx-hxm8","Warn: Project is vulnerable to: GHSA-x5pg-88wf-qq4p","Warn: Project is vulnerable to: GHSA-p9wx-2529-fp83","Warn: Project is vulnerable to: GHSA-5v2h-r2cx-5xgj","Warn: Project is vulnerable to: GHSA-rrrm-qjm4-v8hf","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-wrvr-8mpx-r7pp","Warn: Project is vulnerable to: GHSA-hxm2-r34f-qmc5","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-pc58-wgmc-hfjr","Warn: Project is vulnerable to: GHSA-vvv8-xw5f-3f88","Warn: Project is vulnerable to: GHSA-w9mr-4mfr-499f","Warn: Project is vulnerable to: GHSA-ff6r-5jwm-8292","Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g","Warn: Project is vulnerable to: GHSA-265q-28rp-chq5","Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr","Warn: Project is vulnerable to: GHSA-76c9-3jph-rj3q","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w","Warn: Project is vulnerable to: GHSA-h7cp-r72f-jxh6","Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59","Warn: Project is vulnerable to: GHSA-566m-qj78-rww5","Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-hxcm-v35h-mg2x","Warn: Project is vulnerable to: GHSA-6g33-f262-xjp4","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg","Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p","Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6","Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj","Warn: Project is vulnerable to: GHSA-c9g6-9335-x697","Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3","Warn: Project is vulnerable to: GHSA-mf6x-7mm4-x2g7","Warn: Project is vulnerable to: GHSA-38h8-x697-gh8q","Warn: Project is vulnerable to: GHSA-j44m-qm6p-hp7m","Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9","Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-g7q5-pjjr-gqvp","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-7p7h-4mm5-852v","Warn: Project is vulnerable to: GHSA-xc7v-wxcw-j472","Warn: Project is vulnerable to: GHSA-662x-fhqg-9p8v","Warn: Project is vulnerable to: GHSA-394c-5j6w-4xmx","Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3","Warn: Project is vulnerable to: GHSA-pv4c-p2j5-38j4","Warn: Project is vulnerable to: GHSA-46c4-8wrp-j99v","Warn: Project is vulnerable to: GHSA-9m6j-fcg5-2442","Warn: Project is vulnerable to: GHSA-hh27-ffr2-f2jc","Warn: Project is vulnerable to: GHSA-rqff-837h-mm52","Warn: Project is vulnerable to: GHSA-8v38-pw62-9cw2","Warn: Project is vulnerable to: GHSA-hgjh-723h-mx2j","Warn: Project is vulnerable to: GHSA-jf5r-8hm2-f872","Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6","Warn: Project is vulnerable to: GHSA-cf66-xwfp-gvc4","Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v","Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h","Warn: Project is vulnerable to: GHSA-g78m-2chm-r7qv","Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T11:47:23.198Z","repository_id":57350999,"created_at":"2025-08-18T11:47:23.198Z","updated_at":"2025-08-18T11:47:23.198Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30167963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-01T08:12:53.725Z","updated_at":"2026-03-06T08:32:49.845Z","avatar_url":"https://github.com/ecomfe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# redux-managed-thunk\n[![building status](https://img.shields.io/travis/ecomfe/redux-managed-thunk.svg?style=flat)](https://travis-ci.org/ecomfe/redux-managed-thunk)\n[![Coverage Status](https://img.shields.io/coveralls/ecomfe/redux-managed-thunk.svg?style=flat)](https://coveralls.io/github/ecomfe/redux-managed-thunk)\n[![NPM version](https://img.shields.io/npm/v/redux-managed-thunk.svg?style=flat)](https://www.npmjs.com/package/redux-managed-thunk)\n\nredux-managed-thunk是一个redux中间件，基于thunk提供了强大的异步管理功能。\n\n- [基本理念](#基本理念)\n- [基本使用方式](#基本使用方式)\n    - [与redux-thunk的差异](#与redux-thunk的差异)\n- [dispatch可用性限制](#dispatch可用性限制)\n- [使用consumer扩展中间件](#使用consumer扩展中间件)\n    - [节流与串行化](#节流与串行化)\n    - [依赖注入](#依赖注入)\n    - [组合consumer](#组合consumer)\n    - [自定义consumer](#自定义consumer)\n- [高阶ThunkCreator](#高阶thunk-creator)\n    - [复用前次Thunk](#复用前次thunk)\n    - [取消前次Thunk](#取消前次thunk)\n    - [事务化Thunk](#事务化thunk)\n    - [自定义高阶ThunkCreator](#自定义高阶thunk-creator)\n- [乐观UI支持](#乐观ui支持)\n\n## 基本理念\n\n该中间件在设计的过程中进行过多次的变更，也在[redux-thunk](https://github.com/gaearon/redux-thunk)、[redux-promise](https://github.com/acdlite/redux-promise)、[redux-generator](https://github.com/xuyuanxiang/redux-generator)之间进行过比较和取舍，最终以现在的形式出现，这其中有着很多的考虑。\n\n### 为什么需要thunk\n\n在[redux-promise](https://github.com/acdlite/redux-promise)中，提供给`dispatch`函数的参数是一个Promise对象，这可以用来处理异步的操作，但是这也同时意味着当`dispatch`运行时，一个异步的过程**已经开始执行**了，中间件将对异步的执行时机、顺序等失去控制，这严重影响了应用整体对异步的管理能力。\n\n### 为什么需要Promise\n\n在一个应用中，异步的逻辑是不可避免的，而对异步的处理方式各个中间件也有不同的思路。最为流行的redux-thunk选择提供一个`dispatch`参数以供随时调用，但其带来的代价是由于`dispatch`在任意时刻均可调用，因此**无法知晓一个逻辑何时结束，其结果是成功还是失败**。\n\n因此我们需要有一个模式去标记流程的结束和结果成功与否，一种基于thunk的简单扩展方案是提供额外的回调函数：\n\n```javascript\nlet saveTodo = todo =\u003e async dispatch =\u003e {\n    dispatch({type: 'SAVE_START'});\n\n    let savedTodo = await post('/todos', todo);\n\n    // 使用dispatch.done标记结束\n    dispatch.done({type: 'ADD_TODO', payload: savedTodo});\n};\n```\n\n通过提供`dispatch.done`和`dispatch.fail`函数来标记流程的结束，但这种形式在用户不小心忘记调用这些函数时，依旧无法明确标识出流程的结束，进一步使得对异步流程的管理出现问题（如将所有异步串行化时，因为一个流程无法结束导致所有后续流程不再运行）。\n\n而Promise则存在着一系列的优势，使其成为异步流控制的良好选择：\n\n- 标准支持，符合所有人的预期。\n- ES2018后由语法上的`async`和`await`支持，配合`Promise.all`等方法易于进行异步流控制。\n\n## 基本使用方式\n\n通过npm或yarn进行安装：\n\n```shell\nnpm install --save redux-managed-thunk\n# 或者\nyarn add redux-managed-thunk\n```\n\nredux-managed-thunk的默认export为一个中间件创建函数，调用可产生一个中间件，随后通过`applyMiddleware`使用即可：\n\n```javascript\nimport {createStore, applyMiddleware} from 'redux';\nimport managedThunk from 'redux-managed-thunk';\n\nlet store = createStore(\n    reducer,\n    preloadedState,\n    applyMiddleware(managedThunk())\n);\n```\n\n注意与redux-thunk不同的是，`managedThunk`是一个“创建中间件的函数”，而非一个中间件，所以需要进行一次调用。`managedThunk`函数还接受一个`options`参数，包含以下的属性：\n\n- `{boolean} loose`：用于开启宽松模式，具体参考[dispatch可用性限制](#dispatch可用性限制)章节。\n- `{Function} consumer`：用于控制thunk的派发逻辑，具体参考[使用consumer扩展中间件](#使用consumer扩展中间件)章节。\n\n### 与redux-thunk的差异\n\n在一个redux中间件中，开发者可以访问到2个不同的`dispatch`函数，其一是挂载在`store`对象上的全局的`dispatch`函数，另一个被称之为`next`，用于访问中间件链中的后续中间件。\n\nredux-thunk在调用thunk时，将全局`dispatch`函数作为第一个参数传递给了thunk。但redux-managed-thunk使用的则是`next`函数，这是为了让[乐观UI](#乐观ui支持)可用而作出的设计。\n\n如果你只使用redux-managed-thunk这一个中间件，或者redux-managed-thunk是`applyMiddleware`的第一个参数，那么这一差异并不会产生任何的影响。但如果你在redux-managed-thunk的**前面**还有其它的中间件，那么需要注意在thunk中调用`dispatch`时，之前的中间件并不会起作用。\n\n### 使用DEMO\n\n本仓库带有2个DEMO：\n\n- `npm run demo-cli`将启动一个命令行程序展现[乐观UI](#乐观ui支持)的工作过程。\n- `npm run demo-react`将启动webpack-dev-server运行一个react应用，在应用中展现了[consumer函数](#使用consumer扩展中间件)和[乐观UI](#乐观ui支持)的使用方式。\n\n## dispatch可用性限制\n\nredux-managed-thukn会对`dispatch`参数增加一些限制：\n\n- 如果thunk并没有返回Promise，那么该函数返回后继续调用`dispatch`会抛出异常。\n- 如果thunk返回Promise，那么在Promise进行fulfilled状态后继续调用`dispatch`会抛出异常。\n\n进行额外的检测并抛出异常是为了帮助应用更好地管理异步过程，避免未知时机的`dispatch`调用产生不可预期的应用状态。\n\n如果你希望兼容redux-thunk的方式，任意使用`dispatch`不受限制，那么在创建中间件的时候传入`{loose: true}`参数即可：\n\n```javascript\nimport {createStore, applyMiddleware} from 'redux';\nimport managedThunk from 'redux-managed-thunk';\n\nlet store = createStore(\n    reducer,\n    preloadedState,\n    applyMiddleware(managedThunk({loose: true}))\n);\n```\n\n## 使用consumer扩展中间件\n\nredux-managed-thunk允许自定义`consumer`函数对所有派发的thunk的执行方式进行管理，在调用`managedThunk`创建中间件时提供参数即可。本库内置了一系列常用的cosumer函数。\n\n### 节流与串行化\n\n使用`cocurrency`函数可以支持“同一时间最多同时派发N个thunk”的管理逻辑：\n\n```javascript\ncocurrency = ({number} limit) =\u003e Function\n```\n\n如我们为了控制服务器端的压力，允许同一时间最多派发4个thunk：\n\n\n```javascript\nimport {managedThunk, cocurrency} from 'redux-managed-thunk';\nimport {applyMiddleware} from 'redux';\n\napplyMiddleWare(managedThunk(null, {consumer: cocurrency(4)}));\n```\n\n也可以使用`series`函数来将所有thunk串行化（相当于`cocurrency(1)`），这在类似electron这类renderer和main交互速度很快的应用中能起到简单防止竞态（Race Condition）的作用：\n\n```javascript\nimport {managedThunk, series} from 'redux-managed-thunk';\nimport {applyMiddleware} from 'redux';\n\napplyMiddleWare(managedThunk(null, {consumer: series()}));\n```\n\n### 依赖注入\n\n使用`inject`和`injectWith`函数可以对thunk的参数进行注入，效果类似于redux-thunk的`withExtraArgument`函数的功能：\n\n```javascript\ninject = ({...any} extraArguments) =\u003e Function\ninjectWith ({...Function} factories) =\u003e Function\n```\n\n两者的区别在于`injectWith`的参数为若干个函数，在每一次thunk执行时会运行这些函数并使用其返回值作为参数注入到thunk中，而`inject`则直接将值作为参数。`injectWith`的工厂函数并不支持异步。\n\n```javascript\nimport {managedThunk, injectWith} from 'redux-managed-thunk';\nimport {identity} from 'lodash';\nimport {applyMiddleware} from 'redux';\n\nlet api = {\n    // ...\n};\nlet getCurrentUser = () =\u003e window.currentUser || null;\n\napplyMiddleWare(managedThunk(null, {consumer: injectWith(identity(api), getCurrentUser)}));\n\n// 随后thunk可以获取参数\nlet invalidCurrentUser = async (dispatch, getState, api, currentUser) =\u003e {\n    if (!currentUser) {\n        window.currentUser = await api.getCurrentUser();\n        return dispatch(thunk);\n    }\n\n    dispatch({type: 'INVALID_USER', payload: currentUser});\n};\n```\n\n### 组合consumer\n\n使用`reduceConsumers`函数可以将多个consumer组合为一个，如同时需要`inject`和`series`功能：\n\n```javascript\nimport {managedThunk, series, inject, reducerConsumers} from 'redux-managed-thunk';\nimport {identity} from 'lodash';\nimport {applyMiddleware} from 'redux';\n\nlet api = {\n    // ...\n};\n\napplyMiddleWare(managedThunk(null, {consumer: reducerConsumers(series(), inject(api))}));\n```\n\n### 自定义consumer\n\n你可以任意自定义consumer函数，一个consumer函数符合以下签名：\n\n```javascript\nconsumer = ({Function} run) =\u003e ({Function({Function} thunk)}) =\u003e any;\n```\n\n其接收一个`run`函数，该函数仅接收一个`thunk`函数并返回其执行结果。一个consumer函数在接收到thunk后如无意外应当返回thunk的执行结果（`any`）。\n\n以下示例为一个允许函数异步返回依赖的`injectWith`函数：\n\n```javascript\nlet injectWithAsync(...factories) =\u003e run =\u003e async thunk =\u003e {\n    let extraArguments = await Promise.all(factories.map(fn =\u003e fn()));\n    let injectedThunk = (...args) =\u003e thunk(...args, ...extraArguments);\n    return run(injectedThunk);\n};\n```\n\n## 高阶Thunk Creator\n\n一个Thunk符合以下签名：\n\n```javascript\nThunk = ({Function} dispatch, {Function} getState, {...Function} extraArguments) =\u003e any\n```\n\n一个Thunk Creator是一个创建Thunk的函数：\n\n```javascript\nThunkCreator = ({...any} arguments) =\u003e Thunk\n```\n\n一个高阶Thunk Creator则是一个高阶函数，其接收一个Thunk Creator并返回一个新的Thunk Creator，用以添加一些可复用的行为：\n\n```javascript\nhigherOrderThunkCreator = ({ThunkCreator} next) =\u003e ThunkCreator\n```\n\nredux-managed-thunk内置了几个常用的高阶ThunkCreator用于在Thunk级别对流程进行管理。\n\n### 复用前次Thunk\n\n在基于HTTP协议的应用中，对于一些假定幂等的请求（如`GET`），当其参数相同时，我们往往没有必要重复发起请求。`reusePrevious`提供了复用前次的功能，当前一次的thunk仍在运行中，则不会执行新的thun，而是将前一次的结果（`Promise`）直接返回。\n\n`reusePrevious`接收的`options`参数有如下属性：\n\n- `{Function} shouldReuse`：接受`(currentArgs, previousArgs)`并返回`boolean`来确定是否可以重用前次执行，默认实现为对前后的参数一一进行`shallowEqual`的比较。\n\n```javascript\nimport {reusePrevious} from 'redux-managed-thunk';\n\nlet equal = (x, y) =\u003e x === y;\nlet fetchUser = id =\u003e async dispatch =\u003e {\n    let user = http.get(`/users/${id}`);\n    dispatch({type: 'USER_ARRIVE', payload: user});\n};\nfetchUser = reusePrevious({shouldReuse: equal})(fetchUser);\n\nfetchUser(123);\n// 并不会执行，直接复用前一次的请求，最后仅有一次dispatch调用\nfetchUser(123);\n```\n\n### 取消前次Thunk\n\n对于另一类逻辑，如`PUT`请求，后来者总会对前者的结果进行覆盖，因此当一个新的请求开始时，前一次的请求就不再有意义。`cancelPrevious`提供了取消前次的功能，当一个新的thunk开始执行时，前一次的执行产生的`dispatch`调用都将被忽略。\n\n需要注意的是，事实上在JavaScript领域中我们是无法真正“取消”一个操作的，因此对于`cancelPrevious`来说它仅仅忽略了后续的`dispatch`调用，而在之前已经产生的`dispatch`也无法进行回滚。如果需要避免在取消前就产生某些`dispatch`调用，可以配合[`transactional`](#事务化Thunk)一起使用。另外如果有明确地取消请求的方法，则可以使用`cancel`选项来实现。\n\n`cancelPrevious`接收的`options`参数有如下属性：\n\n- `{Function} shouldCancel`：接受`(currentArgs, previousArgs)`并返回`boolean`来确定是否可以重用前次执行，默认实现为对前后的参数一一进行`shallowEqual`的比较。\n- `{Function} cancel`：接受当前正在执行的`Promise`对象并完成实际的取消工作，默认为空函数。\n\n```javascript\nimport {reusePrevious} from 'redux-managed-thunk';\n\nlet idEqual = (x, y) =\u003e x.id === y.id;\nlet abortFetch = running =\u003e running.abort();\nlet updateUser = user =\u003e async dispatch =\u003e {\n    let updating = http.put(`/users/${user.id}`, user);\n    updating.then(updatedUser =\u003e dispatch({type: 'USER_UPDATE', payload: updatedUser}));\n    return updating;\n};\nupdateUser = cancelPrevious({shouldCancel: idEqual, cancel: abortFetch})(updateUser);\n\nupdateUser({id: 123, name: 'x'});\n// 会立即取消前一次请求，仅将name更新至y\nupdateUser({id: 123, name: 'y'});\n```\n\n### 事务化Thunk\n\n`transactional`函数会将一次thunk运行过程中的所有`dispatch`调用暂存起来，在thunk运行成功后一次性派发。如果thunk运行失败（同步的抛出异常或异步地产生`Promsie#reject`），则所有的`dispatch`都将被丢弃：\n\n```javascript\nimport {transactional} from 'redux-managed-thunk';\n\nlet counter = 1;\nlet decrementCounter = () =\u003e dispatch =\u003e {\n    dispatch({type: 'LOG', payload: 'decrementing...'});\n\n    if (counter === 0) {\n        throw new Error('Cannot decrement');\n    }\n\n    counter--;\n    dispatch({type: 'NEW_COUNTER', counter});\n    dispatch({type: 'LOG', payload: 'decremented'});\n};\ndecrementCounter = transactional()(decrementCounter);\n\ndecrementCounter();\n// 由于抛出异常，在事务中内容为\"decrenmenting...\"的日志不会产生\ndecrementCounter();\n```\n\n### 自定义高阶Thunk Creator\n\n你也可以自己编写需要的高阶ThunkCreator，只需要符合接收一个ThunkCreator并返回新的ThunkCreator的签名即可，如下示例为让某个Thunk运行时在控制台显示函数已经弃用的信息：\n\n```javascript\nlet deprecated = name =\u003e next =\u003e (...args) =\u003e {\n    let thunk = next(...args);\n    return (...thunkArgs) =\u003e {\n        console.warn(`${name} thunk is deprecated`);\n        return thunk(...thunkArgs);\n    };\n};\n// myAPI = deprecated('myAPI')(myAPI);\n```\n\n## 乐观UI支持\n\nredux-managed-thunk同时支持乐观UI，你可以使用`optimisticEnhancer`这一命名导出来打开乐观UI的支持。`optimisticEnhancer`是一个创建Redux StoreEnhancer的函数，用于`createStore`的第3个参数：\n\n```javascript\nimport {createStore} from 'redux';\n\nlet store = createStore(reducer, preloadedState, optimisticEnhancer());\n```\n\n如果与其它的enhancer共用，则可以使用compose函数组合：\n\n\n```javascript\nimport {createStore, compose} from 'redux';\nimport logger from 'redux-logger';\nimport saga from 'redux-saga';\n\nlet store = createStore(\n    reducer,\n    preloadedState,\n    compose(\n        applyMiddleware(logger, saga),\n        optimisticEnhancer({/* options */})\n    )\n);\n```\n\n`optimisticEnhancer`函数接受一个`options`参数，参数定义与默认导出的`managedThunk`函数一致。\n\n乐观UI的使用方式与[redux-optimistic-thunk](https://github.com/ecomfe/redux-optimistic-thunk)相同，只需将一个`[Function, Function]`形式的数组传递给`dispatch`函数即可，这个数组分为2项：\n\n1. 第一项为redux-managed-thunk定义的标准thunk，考虑到乐观UI的特性，该thunk应当是一个异步函数，返回Promise对象。如果该函数为同步函数，则会抛出异常。\n2. 第二项同样为一个thunk，但必须是同步函数。如果该函数为异步函数，则会抛出异常。\n\n当接收到数组时，redux-managed-thunk会按以下步骤进行：\n\n1. 执行第1个thunk，此时该thunk**同步**产生的action都将生效。\n2. 执行第2个thunk，该thunk产生的action都将生效。\n3. 等待第1个thunk第一次**异步**调用`dispatch`函数，随后回滚第2个thunk产生的action。\n4. 继续派发第1个thunk后续的action。\n\nredux-managed-thunk已经通过事务标注的形式处理了各个thunk之间的乱序问题，使用者无需担心thunk的执行顺序会对乐观UI产生影响。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecomfe%2Fredux-managed-thunk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fecomfe%2Fredux-managed-thunk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecomfe%2Fredux-managed-thunk/lists"}