Tests avec NPM ([name])

1. Installez [link:https://www.npmjs.org/ npm] et nodejs. La méthode la plus rapide ressemble généralement à $ sudo apt-get install -y npm nodejs-legacy # fix any problems with SSL in the default registry URL $ npm config set registry http://registry.npmjs.org/
2. Créez un nouveau répertoire de projet $ mkdir test-example; cd test-example
3. Demandez à npm de créer un nouveau fichier de projet pour vous: $ npm init et acceptez tous les paramètres par défaut en appuyant sur Entrée à chaque prompt. Cela créera package.json.


4. Essayez la fonctionnalité de test avec $ npm test Cela va échouer, comme prévu. Si vous jetez un coup d'oeil à votre package.json, la définition du test de script sera "test": "echo \"Error: no test specified\" && exit 1"

Nous allons utiliser [link:https://mochajs.org/ mocha].

1. Installez mocha avec $ npm install mocha --save-dev Remarquez que node_modules/ est créé et que vos dépendances y apparaissent. Notez également que votre package.json a été mis à jour: la propriété devDependencies est ajoutée et mis à jour par l'utilisation de --save-dev.


2. Modifiez votre package.json pour qu'il utilise mocha pour effectuer les tests. Lorsqu'un test est invoqué, nous voulons simplement lancer mocha et spécifier un verbose reporter. Par défaut cela lancera le contenu de test/ (ne pas avoir de répertoire test/ peut causer une npm ERR!, créez le en utilisant mkdir test) "test": "mocha --reporter list"
3. Relancez les tests avec $ npm test Cela doit maintenant réussir, signalant 0 passages (1ms) ou similaire.

1. Ajoutons notre dépendance de three.js avec $ npm install three --save-dev
   • Si vous avez besoin d'une version de three différente, utilisez $ npm show three versions pour voir ce qui est disponible. Pour indiquer à npm la bonne, utilisez $ npm install three@0.84.0 --save (0.84.0 dans cet exemple). --save qui en fait une dépendance de ce projet, au lieu d'une dépendance dev. Voir la documentation [link:https://docs.npmjs.com/cli/v8/configuring-npm/package-json ici] pour plus d'informations.
2. Mocha cherche des tests dans test/, exécutons donc la commande $ mkdir test
3. Finalement, nous avons besoin d'un test JS à lancer. Ajoutons un test simple qui va vérifier que l'objet three.js est disponible et fonctionnel. Créez test/verify-three.js contenant: const THREE = require('three'); const assert = require('assert'); describe('The THREE object', function() { it('should have a defined BasicShadowMap constant', function() { assert.notEqual('undefined', THREE.BasicShadowMap); }), it('should be able to construct a Vector3 with default of x=0', function() { const vec3 = new THREE.Vector3(); assert.equal(0, vec3.x); }) })
4. Finalement testons à nouveau avec $ npm test. Cela doit lancer le test ci-dessous et réussir, affichant quelque chose du genre: The THREE object should have a defined BasicShadowMap constant: 0ms The THREE object should be able to construct a Vector3 with default of x=0: 0ms 2 passing (8ms)

Vous devez faire trois choses:

1. Écrivez un test pour un comportement attendu de votre code, et placez-le sous test/. [link:https://github.com/air/encounter/blob/master/test/Physics-test.js Ici] vous trouverez un exemple issu d'un vrai projet.
2. Exportez votre code de manière à ce que nodejs puisse le voir et l'utiliser quand la conjoncture le requiert. Voir [link:https://github.com/air/encounter/blob/master/js/Physics.js ici].
3. Puis il faut require votre code dans le fichier de test, de la même manière que nous avons require('three') dans l'exemple au-dessus.

Les items 2 et 3 varient selon la façon dont vous organisez votre code. Dans l'exemple de Physics.js montré plus-haut, la partie concernant l'export est à la toute fin. Nous assignons un objet à module.exports:

//============================================================================= // make available in nodejs //============================================================================= if (typeof exports !== 'undefined') { module.exports = Physics; }

Si vous utlisez déjà quelque chose d'astucieux comme require.js ou browserify, sautez cette partie.

Généralement un projet three.js s'exécute dans le navigateur. Le module de chargement est par conséquent réalisé par le navigateur qui exécute un ensemble de scripts. Vos fichiers individuels n'ont pas à gérer les dépendances. Dans un contexte nodejs, il n'y a pas d'index.html reliant tout ensemble, vous devez donc être explicites.

Si vous exportez un module qui dépend d'autres fichiers, vous devrez dire à node de les charger. Voici une approche:

1. Au début de votre module, vérifiez si vous êtes dans un environnement nodejs.
2. Si c'est le cas, déclarez explicitement vos dépendances.
3. Si ce n'est pas le cas, vous êtes probablement dans un navigateur vous n'avez donc rien d'autre à faire.

Code d'exemple issu de Physics.js: //============================================================================= // setup for server-side testing //============================================================================= if (typeof require === 'function') // test for nodejs environment { const THREE = require('three'); const MY3 = require('./MY3.js'); }