Supported platforms

NodeJS

TypeORM was tested on Node.js version 4 and above.

Browser

You can use sql.js in the browser.

Webpack configuration

In the browser folder the package also includes a version compiled as a ES2015 module. If you want to use a different loader this is the point to start. Prior to TypeORM 0.1.7, the package is setup in a way that loaders like webpack will automatically use the browser folder. With 0.1.7 this was dropped to support Webpack usage in Node.js projects. This means, that the NormalModuleReplacementPlugin has to be used to insure that the correct version is loaded for browser projects. The configuration in your webpack config file, for this plugin looks like this:

  1. plugins: [
  2.     ..., // any existing plugins that you already have
  3.     new webpack.NormalModuleReplacementPlugin(/typeorm$/, function (result) {
  4.         result.request = result.request.replace(/typeorm/, "typeorm/browser");
  5.     }),
  6.     new webpack.ProvidePlugin({
  7.       'window.SQL': 'sql.js/js/sql.js'
  8.     })
  9. ]

Example of configuration

  1. createConnection({
  2.     type: "sqljs",
  3.     entities: [
  4.         Photo
  5.     ],
  6.     synchronize: true
  7. });

Don’t forget to include reflect-metadata

In your main html page, you need to include reflect-metadata:

  1. <script src="./node_modules/reflect-metadata/Reflect.js"></script>

Cordova / PhoneGap / Ionic apps

TypeORM is able to run on Cordova, PhoneGap, Ionic apps using thecordova-sqlite-storage pluginYou have the option to choose between module loaders just like in browser package.For an example how to use TypeORM in Cordova see typeorm/cordova-example and for Ionic see typeorm/ionic-example. Important: For use with Ionic, a custom webpack config file is needed! Please checkout the example to see the needed changes.

React Native

TypeORM is able to on React Native apps using the react-native-sqlite-storage plugin. For an example see typeom/react-native-example.

Expo

TypeORM is able to run on Expo apps using the Expo SQLite API. For an example how to use TypeORM in Expo see typeorm/expo-example.

NativeScript

  1. tns install webpack (read below why webpack is required)
  2. tns plugin add nativescript-sqlite

  3. Create Database connection in your app’s entry point

    1.  import driver from 'nativescript-sqlite'
    3.  const connection = await createConnection({
    4.      database: 'test.db',
    5.      type: 'nativescript',
    6.      driver,
    7.      entities: [
    8.          Todo //... whatever entities you have
    9.      ],
    10.      logging: true
    11.  })

Note: This works only with NativeScript 4.x and above

When using with NativeScript, using webpack is compulsory.The typeorm/browser package is raw ES7 code with import/exportwhich will NOT run as it is. It has to be bundled.Please use the tns run --bundle method

Checkout example here!