Selagi kebanyakan inti Django adalah Python, aplikasi penyumbang admin and gis mengandung kode JavaScript.
Silahkan mengikuti standar pengkodean ketika menulis kode javaScript untuk penyertaan di Django.
\nPlease conform to the indentation style dictated in the .editorconfig\nfile. We recommend using a text editor with EditorConfig support to avoid\nindentation and whitespace issues. Most of the JavaScript files use 4 spaces\nfor indentation, but there are some exceptions.
When naming variables, use camelCase instead of underscore_case.\nDifferent JavaScript files sometimes use a different code style. Please try to\nconform to the code style of each file.
Use the JSHint code linter to check your code for bugs and style errors.\nJSHint will be run when you run the JavaScript tests. We also recommended\ninstalling a JSHint plugin in your text editor.
Django's admin system leverages the jQuery framework to increase the\ncapabilities of the admin interface. In conjunction, there is an emphasis on\nadmin JavaScript performance and minimizing overall admin media file size.\nServing compressed or "minified" versions of JavaScript files is considered\nbest practice in this regard.
\nTo that end, patches for JavaScript files should include both the original\ncode for future development (e.g. foo.js), and a compressed version for\nproduction use (e.g. foo.min.js). Any links to the file in the codebase\nshould point to the compressed version.
Untuk menyederhanakan pengolahan menyediakan kode JavaScript yang dioptimalkan, Django menyertakan tulisan Python berguna yang harus digunakan untuk membuat versi "dipekercil". Untuk menjalankannya:
\n$ pip install closure\n$ python django/contrib/admin/bin/compress.py\nBehind the scenes, compress.py is a front-end for Google's\nClosure Compiler which is written in Java. The Closure Compiler library is\nnot bundled with Django, but you can install it using pip as done above. The\nClosure Compiler library requires Java 7 or higher.
Please don't forget to run compress.py and include the diff of the\nminified scripts when submitting patches for Django's JavaScript.
Django's JavaScript tests can be run in a browser or from the command line.\nThe tests are located in a top level js_tests directory.
Percobaan JavasScript Django menggunakan QUnit. Ini adalah sebuah contoh percobaan modul:
\nmodule('magicTricks', {\n beforeEach: function() {\n var $ = django.jQuery;\n $('#qunit-fixture').append('<button class="button"></button>');\n }\n});\n\ntest('removeOnClick removes button on click', function(assert) {\n var $ = django.jQuery;\n removeOnClick('.button');\n assert.equal($('.button').length === 1);\n $('.button').click();\n assert.equal($('.button').length === 0);\n});\n\ntest('copyOnClick adds button on click', function(assert) {\n var $ = django.jQuery;\n copyOnClick('.button');\n assert.equal($('.button').length === 1);\n $('.button').click();\n assert.equal($('.button').length === 2);\n});\nSilahkan rundingkan dokumentasi QUnit untuk informasi pada jenis-jenis dari assertions supported by QUnit.
\nPercobaan JavaScript dapat berjalan dari perambah jaringan atau dari baris perintah.
\nUntuk menjalankan percobaan dari perambah jaringan, buka js_tests/tests.html di perambah anda.
Untuk mengukur cakupan kode ketika menjalankan percobaan, anda butuh melihat berkas itu melalui HTTP. Untuk melihat cakupan kode:
\nJalankan python -m http.server (atau python -m SimpleHTTPServer pada Python 2) dari direktori akar (bukan dari dalam js_tests).
Buka http://localhost:8000/js_tests/tests.html di perambah jaringan anda.
Untuk menjalankan percobaan dari baris perintah, anda butuh mempunyai Node.js terpasang.
\nSetelah memasang Node.js, pasang ketergantungan percobaan JavaScript dengan menjalankan berikut dari akar dari pemeriksaan Django:
\n$ npm install\nlalu jalankan percobaan dengan:
\n$ npm test\n