PHPackages elephfront/robo-import-js - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. elephfront/robo-import-js ActiveRobo-tasks[Utility & Helpers](/categories/utility) elephfront/robo-import-js ========================= Robo task to import the content of a JS file into another one. 1.2.1(8y ago)1241MITPHPPHP >=7.1.0 Since Jan 25Pushed 8y ago1 watchersCompare [ Source](https://github.com/elephfront/robo-import-js)[ Packagist](https://packagist.org/packages/elephfront/robo-import-js)[ RSS](/packages/elephfront-robo-import-js/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (5)Dependencies (2)Versions (6)Used By (1) Robo Import JS ============== [](#robo-import-js) [![Software License](https://camo.githubusercontent.com/9a66612deb245a997157ce51e09a457827107c9cd9a9ee14c908c16fe9ee6f7f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f6272616e63683d6d6173746572)](LICENSE.txt)[![Build Status](https://camo.githubusercontent.com/eceddd35bdcbdcfc6c3903791588ef73b09ba55ce2873a2458594e21062e6428/68747470733a2f2f7472617669732d63692e6f72672f656c65706866726f6e742f726f626f2d696d706f72742d6a732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/elephfront/robo-import-js)[![Codecov](https://camo.githubusercontent.com/8bdf9dd1dda4f8f634a1774eae96090ece4c3cc9c107dd6bb8c9545ca0d65ac2/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f656c65706866726f6e742f726f626f2d696d706f72742d6a732e737667)](https://github.com/elephfront/robo-import-js) This [Robo](https://github.com/consolidation/robo) task brings an import method for Javascript files. Think of it as an equivalent of the PHP `include` function or as the `@import` statement in SASS files for Javascript files. Requirements ------------ [](#requirements) - PHP >= 7.1.0 - Robo Installation ------------ [](#installation) You can install this Robo task using [composer](http://getcomposer.org). The recommended way to install composer packages is: ``` composer require elephfront/robo-import-js ``` Using the task -------------- [](#using-the-task) You can load the task in your RoboFile using the `LoadImportJavascriptTasksTrait` trait: ``` use Elephfront\RoboImportJs\Task\Loader\LoadImportJavascriptTasksTrait; class RoboFile extends Tasks { use LoadImportJavascriptTasksTrait; public function concatJavascript() { $this ->taskImportJavascript([ 'assets/js/main.js' => 'assets/min/js/main.min.js', 'assets/js/home.js' => 'assets/min/js/home.min.js', ]) ->run(); } } ``` The only argument the `taskImportJavascript()` takes is an array (`$destinationsMap`) which maps the source files to the destination files : it will load the **assets/js/main.js**, do its magic and put the final content in **assets/min/js/main.min.js** and do the same for all of the other files. In the end, you will get one file per entry in your maps array. Import in your JS files are made with the fake `roboimport()` method: ``` // in the home.js file roboimport('libs/jquery'); roboimport('plugins/slider.min.js'); var slider = $('.slider').initSlider(); ``` When reading the content of the **home.js** file, the task will replace the `roboimport()` statements with the content of the linked file. This is particularly useful if you want to have very "page specific" production JS files. Note that the task can read nested `roboimport()` statements, meaning an imported file can itself import other files. Chained State support --------------------- [](#chained-state-support) Robo includes a concept called the [Chained State](http://robo.li/collections/#chained-state) that allows tasks that need to work together to be executed in a sequence and pass the state of the execution of a task to the next one. For instance, if you are managing assets files, you will have a task that compile SCSS to CSS then another one that minify the results. The first task can pass the state of its work to the next one, without having to call both methods in a separate sequence. The **robo-import-js** task is compatible with this feature. All you need to do is make the previous task return the content the **robo-import-js** task should operate on using the `data` argument of a `Robo\Result::success()` or `Robo\Result::error()` call. The passed `data` should have the following format: ``` $data = [ 'path/to/source/file' => [ 'js' => '// Some javascript code', 'destination' => 'path/to/destination/file ] ]; ``` In turn, when the **robo-import-js** task is done, it will pass the results of its work to the next task following the same format. Preventing the results from being written ----------------------------------------- [](#preventing-the-results-from-being-written) By default, the **robo-import-js** task writes the result of its work into the destination file(s) passed in the `$destinationsMap` argument. If the **robo-import-js** task is not the last one in the sequence, you can disable the file writing using the `disableWriteFile()` method. The files will be processed but the results will not be persisted and only passed to the response : ``` $this ->taskImportJavascript([ 'assets/js/main.js' => 'assets/min/main.min.js', 'assets/js/home.js' => 'assets/min/home.min.js', ]) ->disableWriteFile() ->someOtherTask() ->run(); ``` Contributing ------------ [](#contributing) If you find a bug or would like to ask for a feature, please use the [GitHub issue tracker](https://github.com/Elephfront/robo-import-js/issues). If you would like to submit a fix or a feature, please fork the repository and [submit a pull request](https://github.com/Elephfront/robo-import-js/pulls). ### Coding standards [](#coding-standards) This repository follows the PSR-2 standard. License ------- [](#license) Copyright (c) 2017, Yves Piquel and licensed under [The MIT License](http://opensource.org/licenses/mit-license.php). Please refer to the LICENSE.txt file. ### Health Score 27 — LowBetter than 49% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community9 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~41 days Total 5 Last Release 3227d ago PHP version history (2 changes)1.0.0PHP >=5.6.0 1.1PHP >=7.1.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c7ade5318f46ea6ffa30a140639a71bb9f078f8322efc24268d0f94cd7c4deee?d=identicon)[HavokInspiration](/maintainers/HavokInspiration) --- Top Contributors [![HavokInspiration](https://avatars.githubusercontent.com/u/5243386?v=4)](https://github.com/HavokInspiration "HavokInspiration (56 commits)") --- Tags elephfrontimport-jsjs-filesroborobo-tasks ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/elephfront-robo-import-js/health.svg) ``` [![Health](https://phpackages.com/badges/elephfront-robo-import-js/health.svg)](https://phpackages.com/packages/elephfront-robo-import-js) ``` ### Alternatives [ec-europa/toolkit Toolkit packaged for Drupal projects based on Robo. 38244.6k16](/packages/ec-europa-toolkit)[globalis/robo-task Robo task common collection 1225.4k2](/packages/globalis-robo-task) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)