# Custom Pre-Import Processor

> This application allows you to run custom code against any source file you upload.

URL: https://store.crowdin.com/custom-pre-import-processor
Category: Development, File Formats
Type: App
Author: Awesome Crowdin

This application allows you to process any file you upload with your own JavaScript code. It can be useful if you want to edit the file content before it's imported by Crowdin.

## Coding
JavaScript code is executed in a sandboxed environment with no access to I/O (file system, network) or external NPM modules.

This app will expose the following variables in the global environment: 
 - `content` - is the content of the uploaded file;
 - `fileName` - the name of the uploaded file;
 - `projectId` - Crowdin project ID;
 - `type` - the ID of the Crowdin file importer that should handle the file;
 - `error` - the error message you want to return. If set, the import will be aborted and the error message will be shown to the user;

You can edit `content` and `fileName` to make the changes you need. Additionally, you can set the specific Crowdin file importer to handle the file import by changing the value of the `type` variable.

## Example application

```javascript
content = content.replace("Test", "Check");
type = "html";
```

## Installation and Setup

1. **Install App.** During installation, select All projects or Selected projects for the app's access.

2. **Navigate to File Processors.** Go to **Project Settings → File Processors** within an installed project.

3. **Insert and Submit Code.** Click on the processor, insert your custom JavaScript code, and click **Submit** to save it.


## Screenshots

![](https://developers.app.crowdin.net/api/media/file/3d740a44-85da-4cad-ae96-1a3af6e06fe2.png)
![](https://developers.app.crowdin.net/api/media/file/4c41c249-b147-4c82-9593-1025da21b8dd.png)