testing

Cara menjalankan dan memperluas tes — unit Mocha, API sanity, Jest TypeScript; env dan mock.

npx skills add https://github.com/contentstack/contentstack-management-javascript --skill testing

Testing – Contentstack Management JavaScript SDK

When to use

  • Running npm run test:unit, sanity, or Jest.
  • Adding or changing tests under test/unit/ or test/sanity-check/.
  • Configuring env vars for live CMA sanity runs.

Instructions

Commands (from package.json)

GoalCommand
Lint (pre-test hook)npm run lint
Default npm testRuns test:api then test:unit — confirm test:api exists in your branch; else use test:unit
Unit onlynpm run test:unit — Mocha test/unit/index.js, nyc
Unit JSON reportnpm run test:unit:report:json
Sanity + coveragenpm run test:sanity-test
Sanity, no nycnpm run test:sanity-nocov
TypeScript / Jestnpm run test:typescript

Always npm run build before sanity if dist/node/contentstack-management.js must match lib/ (sanity imports the built artifact).

Unit tests (test/unit/)

  • Mocha + Chai + @babel/register; 30s timeout per script.
  • HTTP: mock with Nock, axios-mock-adapter, or stubs — no live CMA.
  • Suites are required from test/unit/index.js — add new *-test.js files and register them there.

Sanity tests (test/sanity-check/)

  • Live CMA calls; orchestrated by test/sanity-check/sanity.js.
  • Authoritative env list: test/sanity-check/utility/testSetup.js (and sanity.js).

Environment variables

Required (core) — setup fails without: EMAIL, PASSWORD, HOST, ORGANIZATION.

Suite-specific (tests skip or degrade when missing):

AreaVariablesNotes
OAuthCLIENT_ID, APP_ID, REDIRECT_URIoauth-test.js
2FATFA_EMAIL, TFA_PASSWORDuser-test.js
MFAMFA_SECRETuser-test.js
Team / shareMEMBER_EMAILteam-test.js, stack-test.js
DAM 2.0DAM_2_0_ENABLED=trueentry-test.js

Optional: PERSONALIZE_HOST, DELETE_DYNAMIC_RESOURCES (defaults in setup). Set HOST to your CMA API host.

Runtime: setup assigns API_KEY, AUTHTOKEN, MANAGEMENT_TOKEN, etc. — do not commit those.

Jest (test/typescript/)

  • jest.config.js: ts-jest, coverage under coverage/.

Hygiene

  • No committed only / skip for CI-needed tests.
  • Never commit real tokens in tests or snapshots.

Lebih banyak skill dari contentstack

cms-assets
contentstack
Memberikan saran kepada pengembang tentang pengorganisasian, pengiriman, dan transformasi aset di Contentstack. Mencakup struktur folder, transformasi Image Delivery API, penerbitan…
cms-branches-aliases
contentstack
Memberi saran kepada pengembang tentang penggunaan cabang Contentstack untuk pengembangan konten terisolasi dan alias untuk deployment konten tanpa downtime. Mencakup strategi cabang,…
cms-data-modeling-best-practices
contentstack
Pandu pengembang untuk memodelkan konten di Contentstack menggunakan struktur yang paling sederhana dan dapat digunakan kembali. Skill ini menjelaskan kapan menggunakan tipe konten, referensi, global…
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnosis dan panduan implementasi Contentstack Live Preview dan Visual Builder. Lacak konteks pratinjau, identifikasi kontrak yang rusak, dan rekomendasikan…
cms-releases
contentstack
Memberi saran kepada developer tentang penggunaan Contentstack Releases untuk deployment konten atomik yang terkoordinasi. Mencakup pembuatan release, manajemen item, deployment bertahap,…
cms-roles-permissions
contentstack
Memberi saran kepada pengembang tentang merancang peran, izin, tim, dan akses token di Contentstack. Menjelaskan peran bawaan, peran kustom, penggabungan izin,…
cms-taxonomy
contentstack
Memberi saran kepada pengembang tentang penggunaan Contentstack Taxonomy untuk klasifikasi konten hierarkis terstruktur dan filtering sisi pengiriman. Mencakup taksonomi vs tag,...
cms-tokens-authentication
contentstack
Memberikan saran kepada pengembang tentang cara memilih metode autentikasi Contentstack dan jenis token yang tepat untuk kasus penggunaan frontend, backend, otomasi, dan aplikasi pihak ketiga.