\n ![\"Node](\"https://img.shields.io/node/v/directory-import?logo=nodedotjs&label=Node.JS)
![\"Package](\"https://img.shields.io/github/package-json/v/KiiDii/directory-import?logo=vitess&logoColor=white&label=Package%20version\")
![\"GitHub](\"https://img.shields.io/github/languages/code-size/KiiDii/directory-import?logo=typescript&label=Builded)
![\"License\"](\"https://img.shields.io/github/license/KiiDii/directory-import?logo=mdbook&label=License\")
![\"Github](\"https://img.shields.io/github/actions/workflow/status/KiiDii/directory-import/test.yml?logo=jest&label=Tests\")
![](\"https://img.shields.io/github/issues/KiiDii/directory-import?logo=github&label=Issues\")
![\"Downloads\"](\"https://img.shields.io/npm/dt/directory-import?logo=npm&label=Downloads\")
![\"Discord](\"https://img.shields.io/discord/219557939466338304?logo=discord&label=Discord%20chat\")
\n \n ![\"Install](\"https://nodei.co/npm/directory-import.png?compact=true\")
\n \n
![\"GIF](\"https://github.com/KiiDii/directory-import/blob/master/media/directory-import-example.gif\")
\n\n\n### [Path to directory from the GIF above][pathToDirectoryFromGif]\n\n### Invoking a callback on each file\n\nThis can be handy when, for instance, you need to perform a specific action based on the imported file.\n\n```javascript\nconst { directoryImport } = require('directory-import');\n\ndirectoryImport('./sample-directory', (moduleName, modulePath, moduleData) => {\n console.info({ moduleName, modulePath, moduleData });\n});\n```\n\n\n ![\"GIF](\"https://github.com/KiiDii/directory-import/blob/master/media/directory-import-example-with-callback.gif\")
\n\n\n### {Function} Callback properties:\n\n| Property | Type | Description |\n| -------- | ------ | -------------------------------------------------------------- |\n| name | String | Module name based on the filename |\n| path | String | Relative module path |\n| data | String | Exported data from the module. (Ex: \"module.exports = 'test'\") |\n| index | Number | Index of the imported module |\n\n### {Object} Options properties:\n\n| Property | Type | Description |\n| --------------------- | ------- | --------------------------------------------------------------- |\n| includeSubdirectories | Boolean | If true, the module will import files from subdirectories |\n| targetDirectoryPath | String | The path to the directory from which modules are to be imported |\n| importPattern | RegExp | RegExp pattern to filter files |\n| importMode | String | The import mode. Can be 'sync' or 'async' |\n| limit | Number | Limit the number of imported modules |\n| forceReload | Boolean | If true, reload modules disabling require cache |\n\n[back to top](#top)\n\n---\n\n### More examples:\n\nMinimum code needed for use:\n\n```js\nconst { directoryImport } = require('directory-import');\n\n// Synchronously imports all modules in the same directory from which the code was called\ndirectoryImport();\n```\n\nAsynchronously import files from the specified directory:\n\n```js\nconst { directoryImport } = require('directory-import');\n\nconst result = directoryImport('./path/to/directory', 'async');\n\n// Promise {