A utility for interacting with the Scratch 2.0 website.

Install with npm:

npm install scratch-api

Or by cloning this repository:

git clone https://github.com/trumank/scratch-api.git

Sets the user's backpack to a single script.

var Scratch = require('scratch-api');
Scratch.UserSession.load(function(err, user) {
  if (err) return console.error(err);
  user.setBackpack([{
    type: 'script',
    name: '',
    scripts: [[['say:', 'Cheers!']]]
  }],
  function(err, res) {
    if (err) return console.error(err);
    console.log('Backpack set');
  });
});

Prints all of the cloud variables for the given project.

var Scratch = require('scratch-api');

Scratch.UserSession.load(function(err, user) {
  user.cloudSession(<project>, function(err, cloud) {
    cloud.on('set', function(name, value) {
      console.log(name, value);
    });
  });
});

This scratch-api module is setup to be easily added too and extended. If you need to make certain requests that are not present it should be easy to add them. The Scratch Wiki has some pretty extensive documentation.

If you are feeling Pythonic today, check out Dylan Beswick's very similar module for Python.

• getProject

• static create
• static prompt
• static load
• verify
• getProject
• setProject
• getBackpack
• setBackpack
• addComment
• cloudSession

• end
• get
• set
• variables
• Event: set
• Event: end

Retrieves a JSON object of the given Scratch project. Equivalent to Scratch.UserSession.getProject but does not require being signed in.

• projectId - The project's ID.
• callback(err, project)

Creates a new Scratch session by signing in with the given username and password.

• username - The Scratch account username (not case sensitive).
• password - The Scratch account password.
• callback(err, user)

Creates a new Scratch session by prompting for the username and password via the command line.

• callback(err, user)

Attempts to create a user from a saved .scratchSession file. If one is not found, prompt is used instead and a .scratchSession file is created.

• callback(err, user)

Verifies that the user session is fresh and is ready to be used.

• callback(err, valid)

Retrieves a JSON object of the given Scratch project.

• projectId - The project's ID.
• callback(err, project)

Uploads the given payload object or string to the project with the given ID. The user must own the given project or the request will fail.

• projectId - The project's ID.
• payload - A JSON object or string. If it is an object, it will be stringified before sent.
• callback(err)

Retrieves the signed in user's backpack as a JSON object.

• callback(err, payload)

Uploads the given payload to the user's backpack.

• payload - A JSON object or a string to be uploaded.
• callback(err)

Comments on a project, profile, or studio.

• options - A JSON object containing options.
  • project, user, or studio: The function checks (in that order) for these values. The user must be a username to post to, and all others must be ids.
  • parent: The comment id to reply to. Optional.
  • replyto: The user id to address (@username ...). Optional.
  • content: The text of the comment to post.
• callback(err)

Connects to a cloud variable session for the given project.

• projectId - The project's ID.
• callback(err, cloudSession)

Used to disconnect from the server and end the cloud session.

Returns the value of a cloud variable or undefined if it does not exist.

• name - The variable name including the cloud (☁) symbol.

Sets the variable with the given name to the given value.

• name - The variable name including the cloud (☁) symbol.
• value - A new value.

An object used as a hash table for all cloud variables. Variables can both read set directly via this object or through the corresponding get and set methods.

Emitted when a cloud variable is changed.

• name - The variable name.
• value - The variables new value.

Emitted when the server closes the connection (should never happen unless the client breaks).