Skip to content

File Upload


This sample shows how to create a simple web application for uploading files.


  1. Create a project named file-upload-project.
  2. Right click on the file-upload-project project and select New → TypeScript Service.
  3. Enter service.ts for the name of the TypeScript Service.
  4. Replace the content with the following code:

    import { upload, request, response } from "@dirigible/http";
    if (request.getMethod() === "POST") {
        if (upload.isMultipartContent()) {
            const fileItems = upload.parseRequest();
            for (let i = 0; i < fileItems.size(); i++) {
                const fileItem = fileItems.get(i);
                const contentType = fileItem.getContentType();
                console.log(`Content Type: ${contentType}`);
                console.log(`Filename: ${fileItem.getOriginalFilename()}`);
                // console.log(`Text: ${fileItem.getText()}`);
        } else {
            response.println("The request's content must be 'multipart'");
    } else if (request.getMethod() === "GET") {
        response.println("Use POST request.");


Take a look at the http/upload documentation for more details about the API.

  1. Right click on the file-upload-project project and select New → HTLM5 Page.
  2. Enter index.html for the name of the file.
  3. Replace the content with the following code:

        <form action="/services/ts/file-upload-project/service.ts" method="post" enctype="multipart/form-data">
          <label for="file">Filename:</label>
          <input type="file" name="file" id="file" multiple>
          <input type="submit" name="submit" value="Submit">

Save & Publish

Saving the files will trigger a Publish action, which will build and deploy the TypeScript Service and the HTML5 Page. Select the index.html file and open the Preview view to test the file upload.


Tutorial Completed

After completing the steps in this tutorial, you would have:

  • HTML page to submit the uploaded file to the TypeScript service.
  • Backend TypeScript service that would render the uploaded file.

Note: The complete content of the File Upload tutorial is available at: