Logging in

To log in to an account use the Storage class:

Node ESM

import { Storage } from 'megajs'

const storage = new Storage({
  email: 'user@example.com',
  password: 'correct horse battery example',
  userAgent: 'ExampleApplication/1.0'
})

// Will resolve once the user is logged in
// or reject if some error happens
await storage.ready

Node CJS

  const { Storage } = require('megajs')

// Node doesn't support top-level await when using CJS
;(async function () {
  const storage = new Storage({
    email: 'user@example.com',
    password: 'correct horse battery example',
    userAgent: 'ExampleApplication/1.0'
  })

  // Will resolve once the user is logged in
  // or reject if some error happens
  await storage.ready
}()).catch(error => {
  console.error(error)
  process.exit(1)
})

Browser

import { Storage } from 'https://unpkg.com/megajs/dist/main.browser-es.mjs'

const storage = new Storage({
  email: 'user@example.com',
  password: 'correct horse battery example',
  userAgent: null
})

// Will resolve once the user is logged in
// or reject if some error happens
await storage.ready

Deno

import { Storage } from 'npm:megajs'

const storage = new Storage({
  email: 'user@example.com',
  password: 'correct horse battery example',
  userAgent: 'ExampleApplication/1.0'
})

// Will resolve once the user is logged in
// or reject if some error happens
await storage.ready

It is recommended to set up an user-agent. The library will default to megajs/{version} (where {version} is the library version). When deploying to browsers set userAgent to null as it can cause issues in some browsers which allow client-side code to override the user-agent header (like Firefox).

You can use two-factor authentication, just provide the second factor code like this:

const storage = new Storage({
  ... // same options as before
  secondFactorCode: '123456'
})

You can simplify your code by awaiting the result of new Storage().ready, as .ready resolves to the Storage object, like this:

// Create and already wait for the storage to be ready at the same time
const storage = await new Storage({ ... }).ready

The file uploading example in the home page uses the above shortcut for simplicity.

Events can still be used like in V0:

storage.once('ready', () => {
  // User is now logged in
})

storage.once('error', error => {
  // Some error happened
})

It may look weird to pass a callback to a constructor, but that's an option too:

const storage = new Storage({
  email: 'user@example.com',
  password: 'correct horse battery example',
  userAgent: 'ExampleClient/1.0'
}, error => {
  if (error) {
    // Some error happened
  } else {
    // User is now logged in
  }
})

caution

If you are migrating from tonistiigi's mega you can still use the following code:

const mega = require('megajs')

const storage = mega({
  email: 'user@example.com',
  password: 'correct horse battery example'
}, error => {
  if (error) {
    // Some error happened
  } else {
    // User is now logged in
  }
})

But this pattern might not be supported in future versions because it is not compatible with ES modules and causes issues with tree shaking, which is important when this using this library in a browser environment.

If you try to import the library using import mega from 'megajs' it will throw the following error: SyntaxError: The requested module 'megajs' does not provide an export named 'default'. Notice that, at the moment, Visual Studio Code will load CJS types - which still support this pattern - instead of ESM types even when using import instead of require and, because of that, it will not warn about this issue.

In the next part of this tutorial we will use the Storage object to upload a file.