electron/native_mate
Jeremy Apthorp 6d277ec784 [wip] build: try building node with GN 2018-08-10 10:06:27 -07:00
..
native_mate chore: fix chromium-style errors in native_mate 2018-06-29 12:01:09 -07:00
BUILD.gn [wip] build: try building node with GN 2018-08-10 10:06:27 -07:00
LICENSE.chromium prepare for merging to electron 2018-06-22 11:29:57 +10:00
README.md prepare for merging to electron 2018-06-22 11:29:57 +10:00
native_mate_files.gypi rename back to expected values 2018-06-22 11:42:55 +10:00

README.md

A fork of Chromium's gin library that makes it easier to marshal types between C++ and JavaScript.

Overview

native-mate was forked from gin so that it could be used in Electron without conflicting with Node's Environment. It has also been extended to allow Electron to create classes in JavaScript.

With the help of Chromium's base library, native-mate makes writing JS bindings very easy, and most of the intricate details of converting V8 types to C++ types and back are taken care of auto-magically. In most cases there's no need to use the raw V8 API to implement an API binding.

For example, here's an API binding that doesn't use native-mate:

// static
void Shell::OpenItem(const v8::FunctionCallbackInfo<v8::Value>& args) {
  base::FilePath file_path;
  if (!FromV8Arguments(args, &file_path))
    return node::ThrowTypeError("Bad argument");

  platform_util::OpenItem(file_path);
}

// static
void Shell::Initialize(v8::Handle<v8::Object> target) {
  NODE_SET_METHOD(target, "openItem", OpenItem);
}

And here's the same API binding using native-mate:

void Initialize(v8::Handle<v8::Object> exports) {
  mate::Dictionary dict(v8::Isolate::GetCurrent(), exports);
  dict.SetMethod("openItem", &platform_util::OpenItem);
}

Code Structure

  • converter.h - Templatized JS<->C++ conversion routines for many common C++ types. You can define your own by specializing Converter.
  • function_template.h - Create JavaScript functions that dispatch to any C++ function, member function pointer, or base::Callback.
  • object_template_builder.h - A handy utility for creation of v8::ObjectTemplate.
  • wrappable.h - Base class for C++ classes that want to be owned by the V8 GC. Wrappable objects are automatically deleted when GC discovers that nothing in the V8 heap refers to them. This is also an easy way to expose C++ objects to JavaScript.