Skip to content
MetaSean edited this page Jan 26, 2016 · 1 revision

This page documents simple code snippets which augment or modify basic gun functionality.

Strip metadata from returned nodes

.live() (to replace .on())

Add the following prior to instantiating Gun:

Gun.chain.live = function(cb, opt){ 
  return this.on(function(val, field){ 
    delete val._; 
    cb.call(this, val, field); 
  }, opt); 
}

Instead of using .on(), use .live().
For example,

// subscribe to changes to my player bucket
playerNamesDB.on(function(data){

would be:

// subscribe to changes to my player bucket
playerNamesDB.live(function(data){

For more information, see the thread starting at : https://gitter.im/amark/gun?at=566de558187e75ea0e48771e

.value() (to replace .val())

Add the following prior to instantiating Gun:

Gun.chain.value = function(cb, opt){
  return this.val(function(val, field){
    delete val._;
    cb.call(this, val, field);
  }, opt);
}

Then, instead of using .val(), use .value().
For example,

// subscribe to changes to my player bucket
playerNamesDB.val(function(data){

would be:

// subscribe to changes to my player bucket
playerNamesDB.value(function(data){

For more information, see the thread starting at : https://gitter.im/amark/gun?at=566de558187e75ea0e48771e

Saving/getting images in gun

Gun cannot save dom nodes. That said, you can save a lot of other things, strings included, and image data can be expressed as a string.

Gun.chain.image = function (img) {
  if (!img.src) {
    return this.val(function (src) {
      img.src = src
    });
  }
  var canvas = document.createElement('canvas');
  var ctx = canvas.getContext('2d');
  canvas.width = img.width;
  canvas.height = img.height;
  ctx.drawImage(img, 0, 0, img.width, img.height);
  var data = canvas.toDataURL();
  return this.put(data);
}

Since there is no standard for extracting raw image data, the best way is to render it to a canvas, then read the raw canvas data.

Now you can save your image. Use db.path('example image').image(yourImage). To read it back out again, pass in an image without a .src and the raw data will be loaded onto the empty image.

// writing
var img = find('existingImage')
db.get('images').path('your image').image(img)

// reading
var img = document.createElement('img')
// img.src === undefined
db.get('images').path('your image').image(img)
// img.src === 'data:image/png;base64,iVBO...'

Gun.create() to instantiate without new

Linters will complain if a gun instance is created without the new keyword. You could either use new, or you could use Gun.create([args]).

Gun.create = function () {
  return Gun.apply(this, arguments);
};

Referenced and suggested in issue #6

Using gun for localStorage and peer storage

var me = Gun();                                   // LocalStorage
var gun = Gun('https://gunjs.herokuapp.com/gun'); // peer storage

me.put({"I'm a":'rockstar'}).key('myself');
gun.put({"We're a":'rockband'}).key('myself');

me.get('myself').val();  // Object { _: Object, I'm a: "rockstar" } undefined
gun.get('myself').val(); // Object { _: Object, We're a: "rockband" } undefined

Preventing data synchronization

Supposing your application has user specific data that you don't want to synchronize (for example, a game where you don't want your opponent to know your internal state), you could use this extension to save to localStorage without synchronizing.

Gun.chain.local = function (data, cb, opt) {
  opt = opt || { };
  opt.peers = { };
  return this.put(data, cb, opt)
}

var gun = new Gun().get('example')
gun.path('data').local(private)
gun.path('data').put(synchronized)

note: this should work, but it is still under development.

gun.each

gun.map streams pieces of each node in. To only get the full object, you can use this snippet.

Gun.chain.each = function () {
  var each = this.map();
  return this.val.apply(each, arguments)
}

Usage

gun.get('examples').each(function (example) {
  console.log(example)
})

This wiki is where all the GUN website documentation comes from.

You can read it here or on the website, but the website has some special features like rendering some markdown extensions to create interactive coding tutorials.

Please feel free to improve the docs itself, we need contributions!

Clone this wiki locally