Même si la majorité du code Django est en Python, les applications contribuées admin et gis contiennent du code JavaScript.
Veuillez respecter ces standards de codage lorsque vous écrivez du code JavaScript destiné à faire partie de Django.
\nVeuillez respecter le style d’indentation défini dans le fichier .editorconfig. Nous recommandons d’utiliser un éditeur de texte avec prise en charge de EditorConfig pour éviter des problèmes d’indentation et d’espace. La plupart des fichiers JavaScript utilisent 4 espaces pour l’indentation, mais il y a quelques exceptions.
Lors du nommage des variables, utilisez la notation camelCase plutôt que la séparation_par_soulignement. Il peut arriver que certains fichiers JavaScript utilisent un style de code différent. Merci de vous conformer au style de code de chaque fichier.
Utilisez le vérificateur de code ESLint pour contrôler si votre code contient des bogues ou des erreurs de style. ESLint est lancé en même temps que les tests JavaScript. Nous recommandons également d’installer un greffon ESLint dans votre éditeur de texte.
Lorsque c’est possible, écrivez du code qui fonctionnera même si la structure de la page est modifiée plus tard par du JavaScript. Par exemple, lors de l’inscription d’une fonction de clic, écrivez $('body').on('click', sélecteur, fonction) plutôt que $(sélecteur).click(fonction). Cela simplifie l’extension du comportement par défaut de Django avec JavaScript par d’autres projets.
Le système d’administration de Django exploite la bibliothèque jQuery pour augmenter les capacités de l’interface d’administration. En parallèle, un accent est mis sur les performances du code JavaScript de l’administration et sur la réduction de la taille globale des fichiers statiques de l’administration.
\nLes tests JavaScript de Django peuvent être lancés dans un navigateur ou à partir de la ligne de commande. Les tests sont situés dans un répertoire js_tests au premier niveau.
\nLes tests JavaScript de Django utilisent QUnit. Voici un exemple de module de test :
\nQUnit.module('magicTricks', {\n beforeEach: function() {\n const $ = django.jQuery;\n $('#qunit-fixture').append('<button class="button"></button>');\n }\n});\n\nQUnit.test('removeOnClick removes button on click', function(assert) {\n const $ = django.jQuery;\n removeOnClick('.button');\n assert.equal($('.button').length, 1);\n $('.button').click();\n assert.equal($('.button').length, 0);\n});\n\nQUnit.test('copyOnClick adds button on click', function(assert) {\n const $ = django.jQuery;\n copyOnClick('.button');\n assert.equal($('.button').length, 1);\n $('.button').click();\n assert.equal($('.button').length, 2);\n});\nConsultez la documentation de QUnit pour des informations sur les types d”assertions prises en charge par QUnit.
Les tests JavaScript peuvent être lancés à partir d’un navigateur Web ou de la ligne de commande.
\nPour lancer les tests à partir d’un navigateur Web, ouvrez js_tests/tests.html dans votre navigateur.
\nPour mesure la couverture de code lors de l’exécution des tests, vous devez afficher ce fichier par HTTP. Pour voir la couverture de code :
\nExécutez python -m http.server à partir du répertoire racine (pas depuis le répertoire js_tests).
Ouvrez http://localhost:8000/js_tests/tests.html dans votre navigateur Web.
Pour lancer les tests à partir de la ligne de commande, il est nécessaire que Node.js soit installé.
\nAprès l’installation de Node.js, installez les dépendances de tests JavaScript en exécutant ce qui suit à partir de la racine du dépôt Django :
Linux / macOS
$ npm install\nWindows
...\\> npm install\nPuis, lancez les tests avec :
\nLinux / macOS
$ npm test\nWindows
...\\> npm test\n