Skip to content
A collection of useful functions to deal with Sketch's CocoaScript bridge
Branch: master
Clone or download
Latest commit 888cdee Mar 5, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore fix commit 🎉 Jan 26, 2018
index.js handle source map Aug 6, 2018
package.json safer Mar 5, 2019
prepare-stack-trace.js fix when no options Nov 27, 2018
prepare-value.js safer Mar 5, 2019
source-map-stack-trace.js use Object.assign Sep 6, 2018

Sketch Utils

A collection of useful functions to deal with Sketch's CocoaScript bridge


npm install --save sketch-utils



When an NSArray is bridged by CocoaScript, it is not exactly a JavaScript array, some methods are missing (like map for example). utils.toArray makes sure that you have a proper array.

var utils = require('sketch-utils')

var array = utils.toArray(nsArray)


When an error occurs, CocoaScript returns a stack trace that is not following the NodeJS syntax. utils.prepareStackTrace parses the stack trace and returns an array of callsites.

var utils = require('sketch-utils')

var stackTrace = utils.prepareStackTrace(err.stack)
    fn: string, // the name of the function in which the error occurred
    file: string, // the name of the file in which the error occurred
    filePath: string, // the path to the file
    line: number, // the line at which the error occurred
    column: number // the column at which the error occurred


If you try to log an object, you probably won't get lucky. The CocoaScript bridge makes it really painful to get a meaningful introspection. utils.prepareValue takes any kind of object and return a standardized object that will be well bridged.

The object looks like this:

  type: string, // the type of object. It will be the Obj-C class in case it's a native object
  primitive: string, // for normal object, it will be the same as type. For a native object, it will be a JS primitive (String, Array, Number, etc.) if the object can be assimilated as one; or `Mocha`,
  value: any, // the value (in case of an Object or an Array, each value will be a similar object)
var utils = require('sketch-utils')

var value = utils.prepareValue(x, {
  skipMocha: false, // if false, the value of a native object will be an object {properties, classMethods, instanceMethods, protocols} otherwise, it will be the class name
  withAncestors: false, // if true, the {properties, classMethods, instanceMethods, protocols} object will contains the properties, methods and protocols of the ancestors as well
  withTree: false, // if true, a fifth key will be added to the introspection object: `treeAsDictionary`
You can’t perform that action at this time.