Snapshots in Dart

Send feedback

Written by Siva Annamalai
February 2013

This article talks about snapshots in Dart—both what they are and how they can make Dart apps start up faster. If you write command-line apps, you should be able to improve their startup time by generating your own snapshots, following the instructions in this article.

What is a snapshot?

A snapshot is a sequence of bytes that represents a serialized form of one or more Dart objects. This representation closely corresponds to the way these Dart objects are represented in an isolate’s heap in memory.

The Dart VM uses snapshots for two main reasons:

  • Speeding up initial startup time for an application. A snapshot of the core libraries and application script typically contains preparsed data for the core libraries and the application script. This means it is not necessary to parse and tokenize the libraries and script during startup.

  • Passing objects from one isolate to another isolate.

The Dart VM uses the following kinds of snapshots:

  • A full snapshot, which is a complete representation of an isolate’s heap after it is initialized. This is used by the Dart VM for fast startup and initialization of the entire Dart core library and other libraries such as dart:convert, dart:io, dart:isolate, and so on.

  • A script snapshot, which is a complete representation of an application script in an isolate’s heap after the script is loaded into the isolate, but before the script starts executing. This is used by the Dart VM for fast startup and initialization of applications. For example, the script that starts dart2js uses a pre-created script snapshot of the dart2js application.

  • An object snapshot. Messaging from one isolate to another is implemented in the Dart VM by creating a snapshot of the Dart object that needs to be sent to the other isolate.

How to generate and use script snapshots

You can generate and use script snapshots using the Dart VM (dart).

To generate a script snapshot, use dart with the --snapshot option. You can use the --package_root option to specify the location of packages used in imports (import 'package:...').

dart [--package_root=<path>] --snapshot=<output_file> <dart_file>

The --snapshot option writes a script snapshot of dart-script-file to out-file. For example, the following command creates a snapshot of the Dart script dart2js.dart, putting it into a file called dart2js.snapshot.

dart --snapshot=dart2js.snapshot \
    dart-sdk/lib/dart2js/lib/_internal/compiler/implementation/dart2js.dart

To execute a script from its snapshot, specify the snapshot file on the command line:

dart <snapshot_file> <args>

Any args you specify are passed to the script. For example, you can run dart2js like this, passing myscript.dart -oout.js as command-line arguments to dart2js:

dart dart2js.snapshot myscript.dart -oout.js

Summary

You can find more information about snapshots and how they are implemented by browsing the files in the runtime/vm directory. Start by looking for “Snapshot” in snapshot.h. Note that the code might move as the implementation changes.