---
title: "Cód JavaScript"
version: 6.0
locale: ga
source: https://docs.djangoproject.com/ga/6.0/internals/contributing/writing-code/javascript/
canonical: https://djangodocs.dev/ga/6.0/internals/contributing/writing-code/javascript/
---
# Cód JavaScript

Cé gur Python an chuid is mó de chroí Django, tá cód JavaScript sna feidhmchláir contrib `admin` agus gis\`.

Lean na caighdeáin chódú seo le do thoil agus cód JavaScript á scríobh le haghaidh áireamh i Django.

## Stíl an chód

- Comhlíonadh leis an stíl ionghabhála a ordaítear sa chomhad `.editorconfig`. Molaimid eagarthóir téacs a úsáid le tacaíocht [EditorConfig](https://editorconfig.org/) chun saincheisteanna insint agus spás bán a sheachaint. Úsáideann an chuid is mó de na comhaid JavaScript 4 spás le haghaidh ionbhrú, ach tá roinnt eisceachtaí ann.
- Agus athróga á ainmniú agat, bain úsáid as `camelcase` in ionad `underscore_case`. Uaireanta úsáideann comhaid éagsúla JavaScript stíl chód difriúil. Déan iarracht cloí le stíl chód gach comhad le do thoil.
- Úsáid an linter cód eSlint \_ chun do chód a sheiceáil le haghaidh fabhtanna agus earráidí stíl. Reáchtálfar eSlint nuair a reáchtáil tú na tástálacha JavaScript. Molamar freisin breiseán eSlint a shuiteáil i d'eagarthóir téacs.
- Nuair is féidir, scríobh cód a oibreoidh fiú má athraítear struchtúr an leathanaigh níos déanaí le JavaScript. Mar shampla, nuair a bhíonn láimhseálaí cliceála á cheangal agat, bain úsáid as ```$ ('body') .on ('click', roghnóir, func) ``in ionad ``$ (roghnóir) .click (func)```. Fágann sé seo go bhfuil sé níos éasca do thionscadail iompar réamhshocraithe Django a leathnú le JavaScript.

## Paistí JavaScript

Giarálann córas riaracháin Django creat jQuery chun cumais an chomhéadain riaracháin a mhéadú. I gcomhar, tá béim ar fheidhmíocht riaracháin JavaScript agus méid foriomlán comhad meán riaracháin a íoslaghdú.

## Tástálacha JavaScript

Is féidir tástálacha JavaScript Django a reáchtáil i mbrabhsálaí nó ón líne ordaithe. Tá na tástálacha suite in eolaire barrleibhéil: source: js\_tests.

### Tástála scríbhneo

Úsáideann tástálacha JavaScript Django [Qunit](https://qunitjs.com/). Seo sampla modúl tástála:

```javascript
QUnit.module('magicTricks', {
    beforeEach: function() {
        const $ = django.jQuery;
        $('#qunit-fixture').append('<button class="button"></button>');
    }
});

QUnit.test('removeOnClick removes button on click', function(assert) {
    const $ = django.jQuery;
    removeOnClick('.button');
    assert.equal($('.button').length, 1);
    $('.button').click();
    assert.equal($('.button').length, 0);
});

QUnit.test('copyOnClick adds button on click', function(assert) {
    const $ = django.jQuery;
    copyOnClick('.button');
    assert.equal($('.button').length, 1);
    $('.button').click();
    assert.equal($('.button').length, 2);
});
```

Féach le do thoil ar an gcáipéisíocht `QUnit` chun faisnéis a fháil faoi na cineálacha [dearbhuithe a fhaigheann tacaíocht ó QUnit](https://api.qunitjs.com/assert/).

### Rith tástálacha

Is féidir na tástálacha JavaScript a reáchtáil ó bhrabhsálaí gréasáin nó ón líne ordaithe.

#### Tástáil ó bhrabhsálaí gréasáin

Chun na tástálacha a reáchtáil ó bhrabhsálaí gréasáin, oscail:source: js\_tests/tests.html i do bhrabhsálaí.

Chun clúdach cód a thomhas agus na tástálacha á reáchtáil agat, ní mór duit an comhad sin a fheiceáil thar HTTP. Chun clúdach cód a fheiceáil:

- Feidhmigh `python -m http.server` ón eolaire fréimhe (ní ón taobh istigh `js_tests`).
- Oscail [http://localhost:8000/js\_tests/tests.html](http://localhost:8000/js_tests/tests.html) i do bhrabhsálaí gréasáin.

#### Tástáil ón líne ordaithe

Chun na tástálacha a reáchtáil ón líne ordaithe, ní mór duit Node.js \_ a bheith suiteáilte.

Tar éis duit Node.js a shuiteáil, suiteáil na spleáchais tástála JavaScript tríd an méid seo a leanas a reáchtáil ó fhréamh do sheiceáil Django:

```console
$ npm install
```

*Windows*

```doscon
...\> npm install
```

Ansin reáchtáil na tástálacha le:

```console
$ npm test
```

*Windows*

```doscon
...\> npm test
```