1.3 Namespaces

Het gebruik van strikte scheiding van namespaces in grotere projecten moet je behoeden van de standaard problemen rond dubbel gedefinieerde globale vars in verschillende files.

Het namespace probleem kan je oplossen door voor je scripts zelf de nodige discipline te gebruiken en een eigen namespace te definiëren.

Hoe je dit doet, vind je terug in het volgende document: Namespaces

1.3.1 Maken namespace

Creëer een script file Foo waarvoor je zijn eigen namespace definieert

var Foo = (function() {

'use strict';

// this is namespace object

var foo = {};

return foo;

})();

1.3.2 Toevoegen var en functies aan namespace

Defineer var. Functies en properties die je normaal globaal zou definiëren aan deze definitie.

var Foo = (function() {

'use strict';

// this is namespace object

var foo = {};

// set a local property

foo.name = 'foo';

// a function in this namespace

foo.showName = function () {

Logger.log('namespace ' + foo.name);

};

return foo;

})();

1.3.3 Toevoegen classes

Voeg eventueel classes toe aan deze namespace

var Foo = (function() {

'use strict';

// this is namespace object

var foo = {};

// set a local property

foo.name = 'foo';

// a function in this namespace

foo.showName = function () {

Logger.log('namespace ' + foo.name);

};

// a pseudo class in this name space

foo.speak = function (name) {

// self will refer to this instance

var self = this;

// a local param

var name_ = name;

// a method

self.sayHello = function (message) {

Logger.log('hello from ' +name_ + ' ' + message);

};

// another method

self.sayGoodbye = function (message) {

Logger.log('bye from ' +name_ + ' ' + message);

};

}

return foo;

})();

1.3.4 Gebruik

Je kan deze functies nu gebruiken alsof het library functies zijn in je eigen project.

function test() {

// access a local function in the namespace

Foo.showName();

// a couple of instances

var tom = new Foo.speak ('tom');

var jerry = new Foo.speak ('jerry');

tom.sayHello("cat");

jerry.sayHello("mouse");

tom.sayGoodbye("cat");

jerry.sayGoodbye("mouse");

}

Hierdoor is er geen verschil met lib functies en loop je niet het risico als je code kopieert dat die gebruik maakt van globale vars die ook elders in je project zitten.

Zo kunnen je functies ook nadien eenvoudig als lib ter beschikking gesteld worden.

1.4 Inhibit view in “run from script

Je kan functies verstoppen van het kunnen starten via het run menu. Dit zorgt ervoor dat je “helper functies” niet toevallig kan runnen.

Hiervoor voeg je een _ toe aan het einde van de functienaam.

function notVisibleInRunMenu_(){};

1.5 Good code practices

Video Become a Google Apps Script developer

Best practices Andrew Roberts

Clean Code JavaScript

Apps Script V8 with Visual Studio