{"id":21989059,"url":"https://github.com/imweb/parallel-require","last_synced_at":"2026-05-02T01:33:00.969Z","repository":{"id":22437746,"uuid":"25775880","full_name":"imweb/parallel-require","owner":"imweb","description":"An expansion of require asynchronous model which using in Web APP","archived":false,"fork":false,"pushed_at":"2015-06-28T15:45:31.000Z","size":172,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-01-28T08:51:55.974Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imweb.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-26T14:30:08.000Z","updated_at":"2016-07-08T04:00:41.000Z","dependencies_parsed_at":"2022-08-20T15:40:34.230Z","dependency_job_id":null,"html_url":"https://github.com/imweb/parallel-require","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imweb%2Fparallel-require","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imweb%2Fparallel-require/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imweb%2Fparallel-require/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imweb%2Fparallel-require/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imweb","download_url":"https://codeload.github.com/imweb/parallel-require/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245048276,"owners_count":20552483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-11-29T19:27:33.421Z","updated_at":"2026-05-02T01:33:00.899Z","avatar_url":"https://github.com/imweb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"#parallel-require\n\n\u003e 基于async-parallel模型的require扩展实现。\n\n### 奇葩场景\n\n我要并行加载一个main.js和一个jsonp数据data，但是运行顺序是：\n* main.init()\n* main.render(data)\n\n很显然，通常的require解决不了这个问题，所以就有了parallel-require。\n\n### async-parallel\n\n并发地运行多个异步task，并在所有task完成后回调，经典例子：\n\n``` javascript\nparallel([\n  function (callback) {\n    setTimeout(function () {\n      callback(null, 'one')\n    }, 200)\n  },\n  function (callback) {\n    setTimeout(function () {\n      callback(null, 'two')\n    }, 100)\n  }\n],\n// 可选回调\nfunction (err, results) {\n  // results 将会是 ['one','two']\n})\n```\n\n有趣，这模型和require本身非常像，所以parallel-require就是把这两个模型搅在一起了。\n\n### parallel-require\n\n上面的奇葩场景怎么执行呢？看看下面的例子：\n\n``` javascript\n// 外部并行两个task\nrequire([function (done) {\n    // 一个task是require了main.js，并运行mian.init()\n\trequire(['./main'], function (main) {\n\t\tmain.init();\n\t\tdone(null, main);\n\t});\n}, function (done) {\n    // 第二个task是require了jsonp\n\trequire(['http://localhost/data?jsonpcallback=define'], function (data) {\n\t\tdone(null, data);\n\t})\n}], function (main, data) {\n    // 所有task结束了回调main.render(data)\n\tmain.render(data);\n})\n```\n\nGood，我们成功解决了奇葩场景的问题。\n\n### 再来个例子\n\n比如我们想用XMLHTTPRequest弄点东东回来，再和main.js一起运行\n\n```\nrequire(['./main', function (done) {\n    var xhr = new XMLHttpRequest();\n    xhr.onreadystatechange = function () {\n        if (xhr.readyState === 4) {\n            var sta = xhr.status;\n            if (sta == 200 || sta == 304) {\n                done(null, xhr.dataType !== 'xml' ? xhr.responseText : xhr.responseXML);\n            }else{\n                done(new Error('' + sta));\n            }\n        }\n    };\n    xhr.open('GET', 'http://localhost/data?id=1', true);\n    xhr.send();\n}], function (main, data) {\n    main.init(data);\n});\n```\n\n### 编写规范\n\n基于简化版的AMD规范：\n\n```javascript\n\n// 同步加载模块\nrequire('./myMod');\n\n// 异步加载模块\nrequire(['./myMod'], function (myMod) {\n  console.log(myMod);\n});\n\n// 模块定义\ndefine(['./dep'], function (dep) {\n  function init() {\n    // 初始化\n  }\n  // 返回\n  return init;\n});\n\ndefine(['require', 'exports', 'module', './dep'], function (require, exports, module) {\n  var dep = require('./dep');\n\n  function init() {\n    // 初始化\n  }\n\n  // 返回\n  module.exports = init;\n});\n\n// 设置命名库\nrequire.config({\n  paths: {\n    // 当没有.js?时候会自动添加.js\n    foo: 'libs/foo-1.1.3'\n    // 当存在.js?时，则不会添加，别问我为什么，腾讯的需求＝ ＝\n    mqq: 'http://1.url.cn/mqq.js?bid=123'\n  }\n});\n\n// 设置shim\nrequire.config({\n  paths: {\n    zepto: 'http://pub.idqqimg.com/guagua/qiqimobile/js/libs/zepto.min-e0859e89'\n  },\n  shim: {\n    zepto: {\n      // 目前只提供exports，暂不考虑提供其他能力\n      exports: 'Zepto'\n    }\n  }\n});\n```\n\n### 使用指南\n\u003e 由于是AMD的简化版，所以parallel-require有自己的适用场景，超出适用场景便不建议使用了。\n\n* 较复杂的`Web APP`或`Hybrid APP`\n* HTML非直出，甚至HTML可能利用浏览器或APP缓存机制缓存起来\n* 加载器被inline到HTML中","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimweb%2Fparallel-require","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimweb%2Fparallel-require","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimweb%2Fparallel-require/lists"}