{"id":16292462,"url":"https://github.com/exogen/script-atomic-onload","last_synced_at":"2025-03-20T03:30:49.934Z","repository":{"id":66194763,"uuid":"45146872","full_name":"exogen/script-atomic-onload","owner":"exogen","description":"Test every script loader for correct, atomic onload support","archived":false,"fork":false,"pushed_at":"2018-01-10T08:29:52.000Z","size":376,"stargazers_count":9,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-16T14:53:57.276Z","etag":null,"topics":["async","ie8","internet-explorer","loader","onload","script","script-loader"],"latest_commit_sha":null,"homepage":"","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/exogen.png","metadata":{"files":{"readme":"README.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"exogen","buy_me_a_coffee":"mosswood"}},"created_at":"2015-10-28T22:58:25.000Z","updated_at":"2020-06-12T03:43:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"b727cb8e-1647-43ed-a07f-19f5ba656772","html_url":"https://github.com/exogen/script-atomic-onload","commit_stats":{"total_commits":55,"total_committers":2,"mean_commits":27.5,"dds":"0.19999999999999996","last_synced_commit":"9c0c4cc79ee955b805d1ce9451ab5bbc3347861f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exogen%2Fscript-atomic-onload","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exogen%2Fscript-atomic-onload/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exogen%2Fscript-atomic-onload/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exogen%2Fscript-atomic-onload/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exogen","download_url":"https://codeload.github.com/exogen/script-atomic-onload/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244047646,"owners_count":20389206,"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":["async","ie8","internet-explorer","loader","onload","script","script-loader"],"created_at":"2024-10-10T20:06:45.985Z","updated_at":"2025-03-20T03:30:49.929Z","avatar_url":"https://github.com/exogen.png","language":"JavaScript","funding_links":["https://github.com/sponsors/exogen","https://buymeacoffee.com/mosswood"],"categories":[],"sub_categories":[],"readme":"[![Build Status][script-atomic-onload_img]][travis]\n\nYour script loader probably doesn’t have the callback behavior you want.\n\nUsing a popular library?\n\n[![curl.js Status][curl_img]][travis]\n[![HeadJS Status][headjs_img]][travis]\n[![jQuery Status][jquery_img]][travis]\n[![LABjs Status][labjs_img]][travis]\n[![RequireJS Status][requirejs_img]][travis]\n[![$script.js Status][scriptjs_img]][travis]\n[![yepnope Status][yepnope_img]][travis]\n[![YUI Status][yui_img]][travis]\n\nOr perhaps one of these lesser-known packages?\n\n[![getscript Status][getscript_img]][travis]\n[![JSL Status][jsl_img]][travis]\n[![kist-loader Status][kist-loader_img]][travis]\n[![l.js Status][ljs_img]][travis]\n[![LazyLoad Status][lazyload_img]][travis]\n[![load-script Status][load-script_img]][travis]\n[![loadrunner Status][loadrunner_img]][travis]\n[![loads-js Status][loads-js_img]][travis]\n[![NBL Status][nbl_img]][travis]\n[![script-load Status][script-load_img]][travis]\n[![scriptinclude Status][scriptinclude_img]][travis]\n[![scriptload Status][scriptload_img]][travis]\n[![toast Status][toast_img]][travis]\n\nSorry.\n\nIntroducing…\n\n# script-atomic-onload\n\nA build matrix of every script loader ever made.\n\nThis project tests script loaders for atomic `onload` support, which is the\nonly correct behavior. It also contains a reference implementation, which has\nbeen adopted in the production-ready [little-loader][little-loader] module.\n\n[![little-loader Status][little-loader_img]][travis]\n\n:trophy: **[little-loader][little-loader] is the only correct script loader ever made.**\n\n\n### The only correct behavior…\n\nYes, calling `onload` *immediately* (aka synchronously or atomically) after a\n`\u003cscript\u003e` has executed is the correct and officially defined behavior. So\nwhat’s the problem? **Internet Explorer.** Below version 10, getting this\nbehavior requires you jump through some hoops. **[Even if you don’t support\nInternet Explorer](#i-dont-support-old-ie-anyway-am-i-safe), your script\nloader may be breaking your code in compliant browsers due to its faulty\n`onload` workarounds.** Some script loaders just don’t try; for example,\n[jQuery’s `getScript`][jquery] does not make this guarantee, documenting that\n“The callback is fired once the script has been loaded but not necessarily\nexecuted.” Those that do try often try *very hard* and end up being too clever\nand still incorrect. In giving IE a pass on this behavior, many loaders have\nleft other browsers broken as well.\n\nIf you haven’t designed for it by bundling all your code or using a system\nlike AMD, having other code run in between your script and its `onload`\ncallback can be potentially disastrous. For instance, let’s say you make a\nwidget people can load on their site, and it relies on jQuery. You want to load\njQuery from a CDN. But since your widget might be used on sites that already\nuse jQuery, you need to use `jQuery.noConflict` to keep yours isolated. When\nyou load your version of jQuery in IE, it’s possible other code on the page can\nsee it before your `onload` callback fires. Any code can then modify your\ninstance of jQuery, adding plugins and such (most likely mistaking it for a\ndifferent instance of jQuery). Eventually your `noConflict` gets called, but\nit’s too late – the plugins are attached to the wrong jQuery instance. This is\nnot a problem with jQuery, but with the script loader.\n\nThis particular implementation may not be widely adopted, but it has been\nbattle-tested on many high-traffic, script-laden sites in production. Just\nbecause you’ve never had an issue with your script loader, doesn’t mean it’s\ncorrect! One particular issue that this loader resolved was only ever seen on\none site, and only sometimes (when certain race conditions were triggered).\n\n## Reference Implementation\n\n### Install\n\n```sh\nnpm install script-atomic-onload\n```\n\n### Usage\n\n```javascript\nloadScript(src[, callback, thisValue])\n```\n\nArguments:\n\n* `src`: The URL of the script to load.\n* `callback`: The function to call immediately after the script has executed. It\n  will be called with no arguments, but we reserve the right to pass an `err`\n  parameter in future versions. (Load errors can be difficult to detect on\n  cross-domain scripts in older versions of IE anyway.)\n* `thisValue`: The `this` value that your `callback` will receive.\n\n### Examples\n\n```javascript\nvar loadScript = require(\"script-atomic-onload\");\n\nloadScript(\"https://code.jquery.com/jquery-1.11.3.min.js\", function() {\n  var jQuery = window.jQuery.noConflict(true);\n  // We’re guaranteed to have an instance of jQuery that no other script on the\n  // page has extended or modified.\n});\n```\n\n## I don’t support old IE anyway, am I safe?\n\nMaybe! Have a look at the results from our build matrix:\n\nLibrary | Browser Status\n------: | --------------\n:trophy: **[little-loader][]** | [![little-loader Browser Status][little-loader_browsers_img]][travis]\n[curl.js][curl] | [![curl.js Browser Status][curl_browsers_img]][travis]\n[HeadJS][headjs] | [![HeadJS Browser Status][headjs_browsers_img]][travis]\n[jQuery][jquery] | [![jQuery Browser Status][jquery_browsers_img]][travis]\n[LABjs][labjs] | [![LABjs Browser Status][labjs_browsers_img]][travis]\n[RequireJS][requirejs] | [![RequireJS Browser Status][requirejs_browsers_img]][travis]\n[$script.js][scriptjs] | [![$script.js Browser Status][scriptjs_browsers_img]][travis]\n[yepnope][] | [![yepnope Browser Status][yepnope_browsers_img]][travis]\n[YUI][yui] | [![YUI Browser Status][yui_browsers_img]][travis]\n[getscript][] | [![getscript Browser Status][getscript_browsers_img]][travis]\n[JSL][jsl] | [![JSL Browser Status][jsl_browsers_img]][travis]\n[kist-loader][] | [![kist-loader Browser Status][kist-loader_browsers_img]][travis]\n[l.js][ljs] | [![l.js Browser Status][ljs_browsers_img]][travis]\n[LazyLoad][lazyload] | [![LazyLoad Browser Status][lazyload_browsers_img]][travis]\n[load-script][] | [![load-script Browser Status][load-script_browsers_img]][travis]\n[loadrunner][] | [![loadrunner Browser Status][loadrunner_browsers_img]][travis]\n[loads-js][] | [![loads-js Browser Status][loads-js_browsers_img]][travis]\n[NBL][nbl] | [![NBL Browser Status][nbl_browsers_img]][travis]\n[script-load][] | [![script-load Browser Status][script-load_browsers_img]][travis]\n[scriptinclude][] | [![scriptinclude Browser Status][scriptinclude_browsers_img]][travis]\n[scriptload][] | [![scriptload Browser Status][scriptload_browsers_img]][travis]\n[toast][] | [![toast Browser Status][toast_browsers_img]][travis]\n\n[script-atomic-onload_img]: https://img.shields.io/travis/exogen/script-atomic-onload/master.svg\n[curl_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=curl\u0026label=curl.js\n[getscript_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=getscript\u0026label=getscript\n[headjs_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=headjs\u0026label=HeadJS\n[jquery_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=jquery\u0026label=jQuery\n[jsl_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=jsl\u0026label=JSL\n[kist-loader_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=kist-loader\u0026label=kist-loader\n[labjs_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=labjs\u0026label=LABjs\n[lazyload_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=lazyload\u0026label=LazyLoad\n[little-loader_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=little-loader\u0026label=little-loader\n[ljs_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=ljs\u0026label=l.js\n[load-script_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=load-script\u0026label=load-script\n[loadrunner_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=loadrunner\u0026label=loadrunner\n[loads-js_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=loads-js\u0026label=loads-js\n[nbl_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=nbl\u0026label=NBL\n[requirejs_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=requirejs\u0026label=RequireJS\n[script-load_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=script-load\u0026label=script-load\n[scriptinclude_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=scriptinclude\u0026label=ScriptInclude\n[scriptjs_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=scriptjs\u0026label=$script.js\n[scriptload_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=scriptload\u0026label=scriptload\n[toast_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=toast\u0026label=toast\n[yepnope_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=yepnope\u0026label=yepnope\n[yui_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload?branch=master\u0026env=TEST_LOADER=yui\u0026label=YUI\n\n[script-atomic-onload_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=script-atomic-onload\n[curl_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=curl\n[getscript_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=getscript\n[headjs_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=headjs\n[jquery_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=jquery\n[jsl_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=jsl\n[kist-loader_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=kist-loader\n[labjs_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=labjs\n[lazyload_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=lazyload\n[little-loader_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=little-loader\n[ljs_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=ljs\n[load-script_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=load-script\n[loadrunner_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=loadrunner\n[loads-js_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=loads-js\n[nbl_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=nbl\n[requirejs_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=requirejs\n[script-load_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=script-load\n[scriptinclude_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=scriptinclude\n[scriptjs_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=scriptjs\n[scriptload_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=scriptload\n[toast_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=toast\n[yepnope_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=yepnope\n[yui_browsers_img]: http://badges.herokuapp.com/travis/exogen/script-atomic-onload/sauce/script-atomic-onload?name=yui\n\n[travis]: https://travis-ci.org/exogen/script-atomic-onload\n\n[curl]: https://github.com/cujojs/curl\n[getscript]: https://www.npmjs.com/package/getscript\n[headjs]: http://headjs.com/\n[jquery]: https://api.jquery.com/jquery.getscript\n[jsl]: http://www.andresvidal.com/jsl\n[kist-loader]: https://www.npmjs.com/package/kist-loader\n[labjs]: http://labjs.com/\n[lazyload]: https://github.com/rgrove/lazyload\n[little-loader]: https://github.com/walmartlabs/little-loader\n[ljs]: http://malko.github.io/l.js/\n[load-script]: https://www.npmjs.com/package/load-script\n[loadrunner]: https://github.com/danwrong/loadrunner\n[loads-js]: https://www.npmjs.com/package/loads-js\n[nbl]: http://berklee.github.io/nbl/\n[requirejs]: http://requirejs.org/\n[scriptjs]: https://github.com/ded/script.js\n[scriptload]: https://www.npmjs.com/package/scriptload\n[script-load]: https://www.npmjs.com/package/script-load\n[scriptinclude]: https://www.npmjs.com/package/scriptinclude\n[toast]: https://www.npmjs.com/package/pyrsmk-toast\n[yepnope]: https://github.com/SlexAxton/yepnope.js\n[yui]: http://yuilibrary.com/yui/docs/get/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexogen%2Fscript-atomic-onload","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexogen%2Fscript-atomic-onload","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexogen%2Fscript-atomic-onload/lists"}