Git ва GitHub + ислоҳи хатоҳои код

01 Git: таърихи лоиҳа

Тасаввур кунед, ки шумо барои чойхона сайт месозед. Имрӯз ҳама чиз кор мекунад, пагоҳ шумо менюро «каме ислоҳ кардед», ва сайт вайрон шуд. Чӣ тавр бозгашт кард? Папкаро бо номҳои site-final, site-final-2, site-final-REAL нусха кардан? Навомӯзон ҳамин тавр мекунанд. Касбиҳо Git-ро истифода мебаранд — низоми назорати версияҳо. Он ҳар ҳолати нигоҳдошташудаи лоиҳаро сабт мекунад, нишон медиҳад, ки чӣ ва кӣ тағйир дод, ва имкон медиҳад ба ҳар лаҳза бозгашт кард.

Се минтақа ва чор ҷой

Файл дар Git дар компютери шумо аз се минтақа мегузарад. Ҷойи чорум — сервери GitHub аст, ки шумо нусхаро ба он мефиристед.

Репозиторийи аввал

Як бор дар компютер бояд худро муаррифӣ кунед — ин ном ба ҳар commit меафтад:

git config --global user.name "Ваше Имя"
git config --global user.email "you@example.com"

Акнун лоиҳа эҷод мекунем ва commit-и аввалро мегузаронем:

mkdir chaykhona-site
cd chaykhona-site
git init -b main
echo "# Чойхона" > README.md
git status
git add README.md
git commit -m "docs: add readme"
git log --oneline

Қадам ба қадам чӣ рух дод:

1. git init папкаи пинҳонии .git-ро эҷод кард — тамоми таърих дар он зиндагӣ мекунад. Онро хориҷ кунед, ва лоиҳа дигар репозиторий нахоҳад буд.
2. git status гуфт: файли README.md «untracked» аст — Git онро ҳанӯз пайгирӣ намекунад.
3. git add файлро ба индекс («лифофа») гузошт.
4. git commit -m "…" акси фаврӣ (snapshot)-ро бо имзо сабт кард.
5. git log --oneline таърихро нишон дод: рамзи кӯтоҳи commit ва имзо.

Фармонҳое, ки шумо ҳар рӯз истифода мебаред

Барои ҳис кардани сохти минтақаҳо, онҳоро бо код моделсозӣ мекунем. Ин вазифаи аввал дар саҳифа аст.

const repo = {
  work: ["index.html", "style.css", "app.js"], // файлҳои тағйирёфта
  staged: [],                                  // омодашуда: git add
  commits: [],                                 // таърих: git commit
};

function add(file) {
  // файлро аз work хориҷ кунед ва ба staged гузоред
}

function commit(message) {
  // файлҳоро аз staged ба commit-и нав { message, files } нигоҳ доред
  // ва staged-ро тоза кунед
}

add("index.html");
add("style.css");
commit("add page skeleton");
add("app.js");
commit("add order counter");

for (let i = repo.commits.length - 1; i >= 0; i--) {
  const c = repo.commits[i];
  console.log(`${i + 1}. ${c.message} (${c.files.join(", ")})`);
}
console.log(repo.work.length, repo.staged.length);

2. add order counter (app.js)
1. add page skeleton (index.html, style.css)
0 0

const files = [
  { name: "index.html", tracked: true, changed: false, staged: false },
  { name: "app.js", tracked: true, changed: true, staged: false },
  { name: "notes.txt", tracked: false, changed: true, staged: false },
  { name: "style.css", tracked: true, changed: true, staged: true, changedAfterAdd: false },
  { name: "README.md", tracked: true, changed: true, staged: true, changedAfterAdd: true },
];

function statusLine(f) {
  if (!f.tracked) return `untracked: ${f.name}`;
  if (f.staged) return `to be committed: ${f.name}`;
  if (f.changed) return `modified: ${f.name}`;
  return null; // файли тоза дар статус нишон дода намешавад
}

files.map(statusLine).filter(Boolean).forEach((line) => console.log(line));

modified: app.js
untracked: notes.txt
to be committed: style.css
staged, but changed again: README.md

Муфассалтар хонед: Pro Git — сабти тағйирот дар репозиторий.

02 Шохаҳо: кор мекунем, асосиро вайрон намекунем

Дар репозиторий шохаи асосӣ ҳаст — одатан main (гоҳо онро master меноманд). Дар он версияи «ҳатман кор мекунанда» ҷойгир аст. Функсияи навро дар шохаи алоҳида месозанд: кӯшиш кардан, хато кардан ва commit кардан ба қадри дилхоҳ мумкин аст — шохаи асосӣ зарар намебинад. Вақте функсия тайёр ва санҷида шуд, шохаро бозпас медароранд.

Шоха нусхаи папка нест. Ин танҳо «хатчӯби» ҳаракаткунанда ба яке аз commit-ҳост. Commit-и нав хатчӯбро пеш мебарад. Ба шарофати ин шохаҳо дар Git фавран эҷод мешаванд ва қариб чизе арзиш надоранд. Хатчӯби махсуси HEAD нишон медиҳад, ки шумо ҳоло дар кадом шоха ҳастед.

git branch                         # список веток, звёздочка у текущей
git switch -c feature/filters      # создать ветку и перейти на неё
# ...правим файлы, git add, git commit...
git log --oneline --graph --all    # история в виде дерева
git switch main                    # вернуться на main
git merge feature/filters          # влить ветку в main
git branch -d feature/filters      # удалить ветку, она больше не нужна

Шохаҳоро чӣ тавр номгузорӣ кардан

Дар фармонҳо шохаро аз рӯи қолаби навъ/тавсифи-кӯтоҳ меноманд: feature/order-filters, fix/wrong-total, docs/readme-tajik. Калимаҳои англисӣ, ҳарфҳои хурд, бе фосила, калимаҳо бо дефис. Аз рӯи ном фавран намоён аст, ки дар шоха чӣ ҳаст ва барои чӣ.

Шохаҳо — графи commit-ҳо ҳастанд, ва мо онро бо код гашта метавонем. Аз оддӣ оғоз мекунем: занҷири «падар → падар»-ро мегузарем, чунон ки git log мекунад.

const commits = [
  { id: "c1", parent: null, message: "init project" },
  { id: "c2", parent: "c1", message: "add header" },
  { id: "c3", parent: "c2", message: "add footer" },   // охири main
  { id: "f1", parent: "c2", message: "add filters" },  // шохаи feature аз c2 ҷудо шуд
  { id: "f2", parent: "f1", message: "add sort" },     // охири feature
];
const branches = { main: "c3", feature: "f2" };
const byId = Object.fromEntries(commits.map((c) => [c.id, c]));

function history(branch) {
  // аз branches[branch] оғоз кунед ва аз рӯи parent равед, то он null шавад
}

console.log(history("main").join(" <- "));
console.log(history("feature").join(" <- "));

add footer <- add header <- init project
add sort <- add filters <- add header <- init project

const commits = [
  { id: "c1", parent: null, message: "init project" },
  { id: "c2", parent: "c1", message: "add header" },
  { id: "c3", parent: "c2", message: "add footer" },   // охири main
  { id: "f1", parent: "c2", message: "add filters" },  // шохаи feature аз c2 ҷудо шуд
  { id: "f2", parent: "f1", message: "add sort" },     // охири feature
];
const branches = { main: "c3", feature: "f2" };
const byId = Object.fromEntries(commits.map((c) => [c.id, c]));

function history(branch) {
  const result = [];
  let id = branches[branch];
  while (id !== null) {
    result.push(byId[id].message);
    id = byId[id].parent;
  }
  return result;
}

function onlyIn(branch, base) {
  // массиви паёмҳоро баргардонед
}

console.log(onlyIn("feature", "main").join(", "));
console.log(onlyIn("main", "feature").join(", "));
console.log(onlyIn("main", "main").length);

add sort, add filters
add footer
0

Муфассалтар хонед: Pro Git — дар бораи шохабандӣ дар ду калима.

03 GitHub: push, pull request, ревью

Git дар компютери шумо зиндагӣ мекунад. GitHub — сайтест, ки нусхаи репозиторий дар он нигоҳ дошта мешавад (онро origin — «репозиторийи дур» меноманд). Маҳз тавассути GitHub гурӯҳ коди худро мубодила мекунад, ва корфармо портфолиои шуморо мебинад.

git remote add origin https://github.com/ВАШ_ЛОГИН/chaykhona-site.git
git push -u origin main            # первая отправка, -u запоминает связь веток
git push                           # дальше достаточно просто push
git clone https://github.com/ВАШ_ЛОГИН/chaykhona-site.git   # скачать чужой репозиторий
git pull                           # забрать новые коммиты с GitHub
git fetch                          # только скачать информацию, ничего не менять

git pull — ин fetch (зеркашӣ) + merge (ба шохаи шумо даровардан) аст. Агар дар GitHub commit-ҳои нави ҳамкорон пайдо шуда бошанд, вале дар назди шумо нестанд, пеш аз push аввал pull мекунанд.

Pull request — ғояи асосии кори гурӯҳӣ

Pull request (PR) — ин хоҳиш аст: «тағйироти маро дар шоха бинед ва агар ҳама хуб бошад, онҳоро ба main дароред». PR фармони Git нест, балки имкони GitHub аст. Шумо шохаро push мекунед, дар сайт «Compare & pull request»-ро пахш мекунед, тавсиф менависед, ва ҳамкор тағйиротро сатр ба сатр мехонад, шарҳ мемонад, тасдиқ мекунад ё ислоҳ металабад.

Давраи корӣ дар ҷуфт

Маҳз ҳамин тавр шумо имрӯз дар машғулот ва минбаъд — дар лоиҳаҳо ва дар кор кор мекунед:

1. main-ро навсозӣ кунед: git switch main, git pull.
2. Шоха эҷод кунед барои як вазифа: git switch -c feature/order-filters.
3. Кор кунед ва commit кунед бо қадамҳои хурди бомаъно.
4. Шохаро фиристед: git push -u origin feature/order-filters. GitHub истиноди эҷоди PR-ро чоп мекунад.
5. Pull request-ро кушоед: сарлавҳа, чӣ анҷом шуд, барои чӣ, чӣ тавр санҷидан. Ҳамкорро ҳамчун ревьюер таъин кунед.
6. Ревью: ҳамкор diff-ро мехонад, шарҳ менависад. Шумо ҷавоб медиҳед ва ислоҳ мекунед — commit-ҳои нав ба ҳамон шоха худашон ба PR мерасанд.
7. Merge: пас аз тасдиқ (approve) ва санҷишҳои муваффақ PR-ро бо тугмаи Merge pull request дар GitHub ба main медароранд.
8. Аз паси худ тоза кунед: git switch main, git pull, git branch -d feature/order-filters.

Се роҳи дарорҷарии PR

Барои оғоз варианти якум мувофиқ аст. Дигаронро шумо вақте интихоб мекунед, ки дар гурӯҳ дар бораи услуби таърих мувофиқа кунанд.

function buildPr(pr) {
  // сатрро баргардонед; массиви сатрҳоро ҷамъ кунед ва join("\n")-ро даъват намоед
}

const pr = {
  what: ["добавлен фильтр заказов по статусу", "фильтр запоминается в localStorage"],
  why: "Менеджер хочет быстро находить неоплаченные заказы.",
  check: ["Откройте страницу заказов", "Выберите статус «Не оплачен»", "Обновите страницу: фильтр остался"],
};
console.log(buildPr(pr));

## Что сделано
- добавлен фильтр заказов по статусу
- фильтр запоминается в localStorage

## Зачем
Менеджер хочет быстро находить неоплаченные заказы.

## Как проверить
1. Откройте страницу заказов
2. Выберите статус «Не оплачен»
3. Обновите страницу: фильтр остался

function mergeProblems(pr) {
  const problems = [];
  // чор шартро санҷед ва сабабҳоро ба массив илова кунед
  return problems;
}

const prs = [
  { title: "add order filters", approvals: 1, checks: "passed", conflicts: false, draft: false },
  { title: "fix cart total", approvals: 0, checks: "passed", conflicts: false, draft: false },
  { title: "wip: new header", approvals: 2, checks: "failed", conflicts: true, draft: true },
];
for (const pr of prs) {
  const p = mergeProblems(pr);
  console.log(`${pr.title}: ${p.length ? p.join("; ") : "можно мержить"}`);
}

add order filters: можно мержить
fix cart total: нет одобрения
wip: new header: проверки не прошли; есть конфликт; это черновик

Муфассалтар хонед: GitHub Docs — дар бораи pull request, Pro Git — репозиторийҳои дур.

04 Низоъҳои ҷамъкунӣ (merge conflict)

Git метавонад тағйиротро худкор ҷамъ кунад, агар шумо ва ҳамкор ҷойҳои гуногунро таҳрир карда бошед. Аммо агар шумо ҳарду як сатри ягонаро гуногун тағйир диҳед, Git намедонад, версияи кӣ дуруст аст, ва аз одам хоҳиш мекунад, ки ҳал кунад. Ин низоъ (conflict) аст. Он вайроншавӣ нест, балки қисми оддии кор: дар ҳар гурӯҳ низоъҳо ҳар ҳафта рух медиҳанд.

Фарз кунем, ки шумо бо ҳамкор файли rate.js-ро таҳрир кардед. Ҳамкор шохаи худро аллакай ба main даровард, ва шумо дар шохаи худ git pull origin main кардед:

git switch feature/rate
git pull origin main
# Auto-merging rate.js
# CONFLICT (content): Merge conflict in rate.js
# Automatic merge failed; fix conflicts and then commit the result.

Git истод ва дар файл маркерҳои низоъ-ро сабт кард:

// қурби мубодила
<<<<<<< HEAD
const convertUsd = (usd, rate = 10.9) => Math.round(usd * rate);
=======
const toSomoni = (usd) => usd * 11;
>>>>>>> origin/main

<<<<<<< HEAD

Оғози низоъ. Дар зер — версияи шумо (аз шохае, ки дар он истодаед).

=======

Ҷудокунанда. Дар зер — версияи аз шохаи дигар (дар ин ҷо origin/main).

>>>>>>> origin/main

Охири низоъ ва номи шохае, ки версияи дуюм аз он омадааст.

Низоъро чӣ тавр ҳал кардан

1. Файлро кушоед бо калимаи CONFLICT. Дар VS Code болои блок тугмаҳо пайдо мешаванд: Accept Current (аз они ман), Accept Incoming (аз они бегона), Accept Both (ҳарду) ва Compare.
2. Аз рӯи маъно ҳал кунед, ки чӣ бояд бимонад. Гоҳо бояд порчаҳоро аз ҳарду версия гирифт — ва коди ниҳоиро бо даст навишт. Бо муаллифи таҳрири дуюм мувофиқа кунед.
3. Ҳамаи се сатри маркерҳоро хориҷ кунед. Дар файл танҳо коди муқаррарӣ бояд бимонад.
4. Лоиҳаро иҷро кунед ва боварӣ ҳосил намоед, ки ҳама кор мекунад.
5. Ҷамъкуниро анҷом диҳед:
   Терминал

   git add rate.js
   git commit -m "merge main into feature/rate"
   git push

Маркерҳо — матни оддӣ ҳастанд, ва онҳоро бо код таҳлил кардан мумкин аст. Вазифаи аввалро шумо бо даст, мисли низои ҳақиқӣ ҳал мекунед. Дар дуюмӣ «ҳалли худкор»-ро менависед, чунон ки муҳаррирҳо мекунанд.

const conflicted = `// курс обмена
<<<<<<< HEAD
const toSomoni = (usd) => usd * 11;
=======
const convertUsd = (usd, rate = 10.9) => Math.round(usd * rate);
>>>>>>> feature/rate
`;

const resolved = `// курс обмена
`; // сатри ниҳоии кодро анҷом диҳед

console.log("маркеры остались:", /<<<<<<<|=======|>>>>>>>/.test(resolved));
console.log("имя из main:", resolved.includes("const toSomoni ="));
console.log("формула из feature:", resolved.includes("rate = 10.9") && resolved.includes("Math.round(usd * rate)"));
console.log("лишнее убрано:", !resolved.includes("convertUsd") && !resolved.includes("usd * 11"));

маркеры остались: false
имя из main: true
формула из feature: true
лишнее убрано: true

const conflicted = [
  "<h1>MakeFirstStep</h1>",
  "<<<<<<< HEAD",
  "<p>Курсы программирования</p>",
  "=======",
  "<p>Курсы Frontend и ИИ</p>",
  ">>>>>>> feature/text",
  "<footer>Душанбе</footer>",
].join("\n");

function resolveAll(text, side) {
  const out = [];
  let part = "none"; // none | ours | theirs
  for (const line of text.split("\n")) {
    // коди шумо
  }
  return out.join("\n");
}

for (const side of ["ours", "theirs", "both"]) {
  console.log(side + ": " + resolveAll(conflicted, side).split("\n").join(" / "));
}

ours: <h1>MakeFirstStep</h1> / <p>Курсы программирования</p> / <footer>Душанбе</footer>
theirs: <h1>MakeFirstStep</h1> / <p>Курсы Frontend и ИИ</p> / <footer>Душанбе</footer>
both: <h1>MakeFirstStep</h1> / <p>Курсы программирования</p> / <p>Курсы Frontend и ИИ</p> / <footer>Душанбе</footer>

Муфассалтар хонед: Pro Git — асосҳои шохабандӣ ва ҷамъкунӣ (низоъҳо).

05 .gitignore ва паёмҳои commit

.gitignore: чӣ набояд ба репозиторий афтад

Дар папкаи лоиҳа файлҳое ҳастанд, ки онҳоро дар Git нигоҳ доштан мумкин нест ё лозим нест. Онҳоро дар файли .gitignore дар решаи лоиҳа номбар мекунанд: Git онҳоро пайгирӣ намекунад ва дар git status нишон намедиҳад.

# зависимости: восстанавливаются командой npm install
node_modules/

# готовая сборка: создаётся командой npm run build
dist/

# секреты: пароли, ключи API
.env

# логи и системный мусор
*.log
.DS_Store

ном/

Папка бо ин ном, ҳар ҷое ки бошад: dist/, node_modules/.

*.васеъкунӣ

Ҳамаи файлҳо бо чунин анҷом: *.log.

ном

Файл бо айнан чунин ном: .env. Файли .env.example ба ин қоида намеафтад.

!ном

Истисно: файлро ба назорати Git баргардонидан. Пас аз қоидаи умумӣ меистад.

# матн

Шарҳ.

.gitignore-и ҳақиқӣ боз бисёр синтаксисро дастгирӣ мекунад (**, роҳҳо бо хати моил), аммо ин қариб ҳамеша кифоя аст. Дар вазифаи зер шумо маҳз чунин «муҳаррики» соддакардашударо истифода мебаред.

Паёмҳои commit: Conventional Commits

Пас аз ним сол шумо ба ёд намеоред, ки «update» ё «fix» чӣ маъно дошт. Барои ҳамин дар гурӯҳҳо дар бораи формат мувофиқа мекунанд: навъ(соҳа): чӣ анҷом шуд. Соҳа ихтиёрӣ аст.

Барои мустаҳкам кардан мебинем, ки таснифи паёмҳо дар код чӣ гуна менамояд. Мисолро иҷро кунед ва паёмҳоро тағйир диҳед:

const messages = ["feat: add filters", "fix(cart): sum", "update", "docs: readme"];

for (const m of messages) {
  const match = m.match(/^([a-z]+)(\([^)]*\))?: /);
  console.log(m.padEnd(20), "->", match ? match[1] : "нет типа");
}

function matchRule(rule, path) {
  const parts = path.split("/");
  const name = parts[parts.length - 1];
  if (rule.endsWith("/")) {                          // «папка/»: ҳар феҳрист бо чунин ном
    return parts.slice(0, -1).includes(rule.slice(0, -1));
  }
  if (rule.startsWith("*.")) return name.endsWith(rule.slice(1)); // «*.log»: аз рӯи васеъкунӣ
  return name === rule;                              // номи дақиқи файл
}

function isIgnored(path, rules) {
  let ignored = false;
  for (const rule of rules) {                        // қоидаҳо аз боло ба поён хонда мешаванд
    if (rule.startsWith("!")) {                      // «!ном» файлро бозпас мегардонад
      if (matchRule(rule.slice(1), path)) ignored = false;
    } else if (matchRule(rule, path)) {
      ignored = true;
    }
  }
  return ignored;
}

const paths = [
  "node_modules/react/index.js", "dist/app.js", "src/app.js", ".env", ".env.example",
  "debug.log", "logs/server.log", "keep.log", "README.md", ".DS_Store", "src/.DS_Store", "coverage/index.html",
];

const rules = [
  // қоидаҳоро бо сатрҳо нависед
];

console.log("игнорируются:", paths.filter((p) => isIgnored(p, rules)).join(", "));
console.log("остаются:", paths.filter((p) => !isIgnored(p, rules)).join(", "));

игнорируются: node_modules/react/index.js, dist/app.js, .env, debug.log, logs/server.log, .DS_Store, src/.DS_Store, coverage/index.html
остаются: src/app.js, .env.example, keep.log, README.md

const messages = [
  "feat: add order filters",
  "fix: wrong total in cart",
  "docs: update readme",
  "fix(cart): off-by-one in loop",
  "update",
  "feat(ui): dark theme",
  "fix: crash on empty order",
  "Changes",
];

function commitType(msg) {
  // регулярка: калима дар аввал, (соҳа)-и ихтиёрӣ, дунуқта ва фосила
  return "other";
}

const counts = {};
for (const m of messages) {
  const type = commitType(m);
  counts[type] = (counts[type] || 0) + 1;
}
console.log(JSON.stringify(counts));

{"feat":2,"fix":3,"docs":1,"other":2}

function lintCommit(msg) {
  const problems = [];
  return problems;
}

const list = [
  "feat: add order filters",
  "Fixed bug.",
  "fix(cart): Wrong total.",
  "docs: describe in the readme how to install dependencies and run the project",
];
for (const m of list) {
  const p = lintCommit(m);
  console.log(`${m.slice(0, 24)} -> ${p.length ? p.join("; ") : "ok"}`);
}

feat: add order filters -> ok
Fixed bug. -> нет типа вида feat: …
fix(cart): Wrong total. -> тема с заглавной буквы; точка в конце
docs: describe in the re -> тема длиннее 50 символов

Муфассалтар хонед: Conventional Commits, ҳуҷҷатҳои .gitignore.

06 Хатоҳо: try / catch / finally ва throw

Хатоҳо ба ҳама рух медиҳанд: корбар сатри холӣ ворид кард, сервер ҷавоб надод, аз localStorage партов омад. Агар коре накунем, барнома дар сатри аввалини дорои хато меистад. Вазифаи таҳиягар — пешакӣ дида баромадани ҷойҳоест, ки код метавонад биафтад, ва ҳамин тавр кардан, ки корбар паёми фаҳморо бубинад, на экрани сафедро.

try / catch / finally

function readAge(text) {
  try {
    const age = JSON.parse(text);          // метавонад хато партояд
    console.log("прочитали:", age);
    return age;
  } catch (error) {
    console.log("не получилось:", error.name);
    return 0;                              // нақшаи эҳтиётӣ
  } finally {
    console.log("— чтение закончено —");   // ҳамеша иҷро мешавад
  }
}

console.log(readAge("19"));
console.log(readAge("девятнадцать"));

Хато дар дохили try онро фавран қатъ мекунад, ва идора ба catch мегузарад. Сатрҳои боқимондаи try гузашта мешаванд. Ба catch объекти хато меояд (онро одатан error ё e меноманд).

Дар дохили объекти хато чӣ ҳаст

name

Навъи хато: TypeError, ReferenceError, SyntaxError, RangeError…

message

Тавсифи инсонӣ: «Cannot read properties of null».

stack

Стеки даъватҳо — занҷири функсияҳое, ки ба хато овардаанд. Дар қисми 7 таҳлил мекунем.

Навъҳои асосии хатоҳо

try {
  const user = null;
  console.log(user.name);
} catch (error) {
  console.log("name:", error.name);
  console.log("message:", error.message);
  console.log("есть stack:", typeof error.stack === "string");
}

throw: хатои худро мепартоем

Гоҳо хаторо худатон бояд эҷод кунед. Масалан, функсия аз корбар миқдори манфӣ гирифт. throw функсияи ҷориро қатъ мекунад ва хаторо ба боло — то наздиктарин catch «мепартояд». Объекти хато-ро партоед (new Error("матн")), на танҳо сатр: объект стек дорад.

function setQuantity(qty) {
  if (!Number.isInteger(qty)) throw new TypeError("Количество должно быть целым числом");
  if (qty < 1) throw new RangeError("Количество не может быть меньше 1");
  return qty;
}

for (const value of [3, 0, 2.5]) {
  try {
    console.log("ок:", setQuantity(value));
  } catch (e) {
    console.log(`${e.name}: ${e.message}`);
  }
}

function risky() {
  throw new Error("что-то пошло не так");
}

risky();   // хато гирифта нашуд: иҷро қатъ шуд
console.log("до этой строки мы уже не дойдём");

Хатоҳоро дар коди ғайримуттаҳид бо ҳамон try / catch дар гирди await мегиранд (шумо инро дар дарси 13 дидед, ва дар дарсҳои минбаъда ҳамин тавр дархостҳои fetch-ро коркард мекунед). try-и алоҳида дар гирди setTimeout кор намекунад: колбэк баъдтар иҷро мешавад, вақте блок аллакай анҷом ёфтааст.

const log = [];   // дар ин ҷо код «баромад»-ро ҷамъ мекунад
function test() {
  try {
    log.push("1: try");
    return "результат";
  } catch (e) {
    log.push("catch");
  } finally {
    log.push("2: finally");
  }
  log.push("после");
}
log.push("3: " + test());

const prediction = [];   // пешгӯии шумо: сатрҳо бо тартиб
console.log(log.join("|") === prediction.join("|") ? "Верно!" : "Не угадали, подумайте ещё");

Верно!

function errorName(fn) {
  // try / catch
}

const tests = [
  () => { const user = null; return user.name; },
  () => missingVariable + 1,
  () => JSON.parse("{name: 'Али'}"),
  () => new Array(-5),
  () => 2 + 2,
];
tests.forEach((t, i) => console.log(i + 1, errorName(t)));

1 TypeError
2 ReferenceError
3 SyntaxError
4 RangeError
5 ok

function safeParse(text, fallback) {
  // try / catch
}

console.log(safeParse('{"name":"Фарҳод","age":19}', null).name);
console.log(safeParse("{name: Фарҳод}", "пусто"));
console.log(safeParse("", []).length);

Фарҳод
ошибка чтения: SyntaxError
пусто
ошибка чтения: SyntaxError
0

function withdraw(balance, amount) {
  // ду санҷиш бо throw, баъд return
}

for (const amount of [200, 0, 5000, -10]) {
  try {
    console.log("остаток:", withdraw(1000, amount));
  } catch (e) {
    console.log(`${e.name}: ${e.message}`);
  } finally {
    console.log("— операция завершена —");
  }
}

остаток: 800
— операция завершена —
RangeError: Сумма должна быть больше нуля
— операция завершена —
Error: Недостаточно сомони
— операция завершена —
RangeError: Сумма должна быть больше нуля
— операция завершена —

function fail(field, message) {
  const e = new Error(message);
  e.name = "ValidationError";
  e.field = field;
  throw e;
}

function validate(order) {
  // ду санҷиш тавассути fail(...)
}

function process(order) {
  try {
    validate(order);
    return "заказ принят";
  } catch (e) {
    if (e.name === "ValidationError") return `поле ${e.field}: ${e.message}`;
    throw e; // хатоҳои бегонаро фурӯ намебарем
  }
}

console.log(process({ name: "Мадина", qty: 2 }));
console.log(process({ name: "", qty: 2 }));
console.log(process({ name: "Рустам", qty: 0 }));
try {
  process(null);
} catch (e) {
  console.log("неожиданная ошибка:", e.name);
}

заказ принят
поле name: укажите имя
поле qty: минимум 1 штука
неожиданная ошибка: TypeError

Муфассалтар хонед: learn.javascript.ru — коркарди хатоҳо, try…catch, MDN — try...catch.

07 Стеки даъватҳо ва DevTools

Хатои сурхро чӣ тавр хондан

Вақте код меафтад, браузер сатри сурх ва стеки даъватҳо-ро чоп мекунад: рӯйхати функсияҳо аз ҷойи хато то оғози кор. Онро аз боло ба поён хонед: сатри якум — дар куҷо афтод, сатрҳои баъдӣ — кӣ ин функсияро даъват кард.

Uncaught TypeError: Cannot read properties of undefined (reading 'price')
    at calcTotal (cart.js:12:23)
    at renderCart (ui.js:48:15)
    at HTMLButtonElement.<anonymous> (main.js:7:3)

1. Навъ ва паём: TypeError — хосияти price-ро аз undefined мехонем. Яъне дар ягон ҷо ба ҷои маҳсулот undefined омад.
2. Сатри болоии стек: calcTotal (cart.js:12:23) — функсияи calcTotal, файли cart.js, сатри 12, аломати 23. Дар ин ҷо афтод.
3. Сатри дуюм: renderCart calcTotal-ро даъват кард. Аксар вақт хато на дар функсияи боло, балки дар он чизест, ки ба он дода шуд.
4. Сатри охирин: ҳама чиз аз зеркунӣ ба тугма дар main.js оғоз шуд.

Зеркунӣ ба cart.js:12 дар консоли DevTools ҳамон файлро дар сатри даркорӣ мекушояд.

function inner() {
  throw new Error("сломалось внутри");
}
function outer() {
  inner();
}

try {
  outer();
} catch (e) {
  const first = e.stack.split("\n")[0];   // сатри якуми стек — «Навъ: паём»
  console.log(first);
  console.log("в стеке есть outer:", e.stack.includes("outer"));
}

DevTools: абзорҳои таҳиягар

DevTools-ро дар ҳар саҳифа кушоед: F12 ё Ctrl+Shift+I (дар Mac — Cmd+Option+I). Ҷадвалҳои асосӣ барои ислоҳи хато:

Console — консол

Хатоҳо, огоҳиҳо ва console.log-ҳои шуморо нишон медиҳад. JavaScript-ро бевосита дар консол навиштан ва фавран натиҷа гирифтан мумкин аст. Методҳои муфид:

const price = 20;
const qty = 3;

console.log(price, qty);           // 20 3 — чӣ чист?
console.log({ price, qty });       // { price: 20, qty: 3 } — фавран фаҳмост
console.log("итого:", price * qty);

Sources — ислоҳи қадам ба қадам ва breakpoint-ҳо

Ба ҷои даҳҳо console.log метавонед барномаро дар сатри даркорӣ қатъ кунед ва атрофро дида бароед. Ҷадвали Sources-ро кушоед, файлро интихоб кунед ва ба рақами сатр дар чап зер кунед: нишони кабуд — breakpoint пайдо мешавад. Акнун дар саҳифа амалеро иҷро кунед (масалан, тугмаро пахш кунед): иҷро пеш аз ин сатр қатъ мешавад.

1. Атрофро бубинед. Дар тарафи рост дар панели Scope қиматҳои ҳамаи тағйирёбандаҳо дар ин лаҳза намоёнанд. Дар Watch ҳар ифодаро илова кардан мумкин аст, масалан items.length. Дар Call Stack — ҳамон стеки даъватҳо.
2. Қадам ба қадам равед. F10 (Step over) — сатрро иҷро кардан ва ба навбатӣ гузаштан. F11 (Step into) — ба дохили функсияи даъватшаванда даромадан. Shift+F11 (Step out) — аз функсия баромадан. F8 — то breakpoint-и навбатӣ идома додан.
3. Интизориро бо воқеият муқоиса кунед. Дар кадом сатр қимат на он тавр шуд, ки шумо меандешидед? Ин ҳамон ҷойи хатост.

Вариантҳои қулай: breakpoint-и шартӣ (зеркунии рост ба рақами сатр → Add conditional breakpoint, масалан i === 3) ва Pause on exceptions (тугмаи бо таваққуф): DevTools худаш дар лаҳзае, ки код хато меандозад, қатъ мешавад.

Оператори debugger

Агар ҷустуҷӯи сатри даркорӣ дар DevTools намехоҳед, дар код оператори debugger;-ро гузоред. Вақте DevTools кушода аст, иҷро маҳз дар ҳамин ҷо, мисли breakpoint, қатъ мешавад. Агар DevTools баста бошад, оператор ҳеҷ кор намекунад.

function calcTotal(items) {
  let sum = 0;
  for (const item of items) {
    debugger;               // дар ин ҷо барнома қатъ мешавад, агар DevTools кушода бошад
    sum += item.price;
  }
  return sum;
}

Network — шабака

Ҷадвали Network ҳар дархости саҳифаро нишон медиҳад: HTML, расмҳо, fetch ба API. Онро пеш аз амал дар саҳифа фаъол кунед (ё саҳифаро навсозӣ намоед). Барои дархостҳои fetch филтри Fetch/XHR-ро пахш кунед.

• Status: 200 — муваффақият, 404 — нишонӣ ёфт нашуд, 500 — сервер вайрон шуд. Сатри сурх — дархост ноком шуд (масалан, интернет нест).
• Ба дархост зер кунед: Headers (нишонӣ, метод, сарлавҳаҳо), Payload (чӣ фиристодем), Preview / Response (сервер чӣ ҷавоб дод), Timing (чанд интизор шудем).
• Саволи маъмул «чаро дар саҳифа холӣ аст?»: дар Network менигарем — оё ҷавоб омад, кадом статус, оё дар баданаи ҷавоб хато нест.

Усули ислоҳи хато: шаш қадам

1. Хаторо такрор кунед: дақиқан чиро пахш кардан ва ворид кардан лозим, то он ҳар дафъа такрор шавад.
2. Танг кунед: ҳар чизи зиёдатиро хориҷ кунед, то коди ҳадди ақал бо хато бимонад.
3. Паёми хато ва стекро бихонед. Аксар вақт ҷавоб аллакай дар он навишта шудааст.
4. Фарзияро пешниҳод кунед: «қимат дар ин ҷо undefined шуд, зеро…».
5. Фарзияро бо як санҷиш месанҷед: console.log ё breakpoint. Як адад, на панҷто якбора.
6. Ислоҳ кунед ва аз нав санҷед: хато рафт, боқӣ вайрон нашуд? Дар commit нависед, ки сабаб чӣ буд.

const stack = `TypeError: Cannot read properties of undefined (reading 'price')
    at calcTotal (cart.js:12:23)
    at renderCart (ui.js:48:15)
    at HTMLButtonElement.<anonymous> (main.js:7:3)`;

function parseFrame(line) {
  // регулярка: at (.+?) \((.+?):(\d+):(\d+)\)
  return { fn: "?", file: "?", line: 0 };
}

const frames = stack.split("\n").filter((l) => l.trim().startsWith("at ")).map(parseFrame);
console.log("ошибка в:", frames[0].fn, frames[0].file, frames[0].line);
console.log("глубина стека:", frames.length);
console.log("всё началось в файле:", frames[frames.length - 1].file);

ошибка в: calcTotal cart.js 12
глубина стека: 3
всё началось в файле: main.js

function sumPositive(numbers) {
  let sum = 0;
  for (const n of numbers) {
    if (n > 0) sum += n;
    // дар ин ҷо console.log илова кунед
  }
  return sum;
}

console.log(sumPositive([5, -3, 10, 0, 7]));

n=5, sum=5
n=-3, sum=5
n=10, sum=15
n=0, sum=15
n=7, sum=22
22

Муфассалтар хонед: Chrome DevTools — ислоҳи JavaScript, learn.javascript.ru — ислоҳи хато дар браузер.

08 Хаторо ёбед ва ислоҳ кунед

Қисми зиёди хатоҳо — маҷмӯи хурди хатоҳои «классикӣ» мебошад. Агар донед, ки онҳо чӣ гуна менамоянд, ҷустуҷӯ чандин маротиба тезтар мешавад. Инак харита:

Мисоли таҳлил

Инак хато ва ислоҳи он «бо суханон». Иҷро кунед:

const scores = [70, 85, 90];

function average(list) {
  let sum = 0;
  for (let i = 0; i < list.length; i++) {
    sum += list[i];
  }
  return sum / list.length + 1;
}

console.log(average(scores));

Тақрибан 81.67 интизор будем, тақрибан 82.67 гирифтем. Фарзия: чизе зиёдатӣ илова мешавад. Санҷиш: console.log(sum / list.length) пеш аз return — ин 81.67 аст. Яъне, гунаҳкор сатри охирин аст: + 1 зиёдатӣ аст. Мебинед: мо «ба тахмин ислоҳ накардем», балки ҷустуҷӯро бо санҷиш танг кардем.

Off-by-one ва муқоисаҳои нодуруст

const prices = [120, 80, 45, 200];

function total(list) {
  let sum = 0;
  for (let i = 0; i <= list.length; i++) {
    sum += list[i];
  }
  return sum;
}

console.log(total(prices));

445

const students = ["Алишер", "Бахтиёр", "Дилшод", "Зарина", "Мадина", "Нигина", "Рустам"];

function getPage(list, page, size) {
  const start = page * size;
  return list.slice(start, start + size);
}

console.log(getPage(students, 1, 3).join(", "));
console.log(getPage(students, 2, 3).join(", "));
console.log(getPage(students, 3, 3).join(", "));

Алишер, Бахтиёр, Дилшод
Зарина, Мадина, Нигина
Рустам

function top3(scores) {
  const sorted = [...scores].sort();
  return sorted.reverse().slice(0, 3);
}

console.log(top3([85, 9, 100, 42, 7]).join(", "));

100, 85, 42

function cheaper(a, b) {
  return a < b ? a : b;
}

function label(price) {
  if (price = 0) return "бесплатно";
  return price + " сомони";
}

console.log(cheaper("9", "100"));
console.log(cheaper("45", "5"));
console.log(label(35));
console.log(label(0));

9
5
35 сомони
бесплатно

const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function cook(dish) {
  await delay(10);
  return `${dish} готов`;
}

const dishes = ["плов", "самбуса", "лагман"];

async function main() {
  dishes.forEach(async (d) => {
    console.log(await cook(d));
  });
  console.log("Все блюда готовы!");
}

main();

плов готов
самбуса готов
лагман готов
Все блюда готовы!

const getPrice = (id) => new Promise((resolve) => setTimeout(() => resolve(id * 10), 20));

async function showTotal() {
  const a = getPrice(3);
  const b = getPrice(5);
  console.log("Итого:", a + b);
}

showTotal();

Итого: 80

for (var i = 1; i <= 3; i++) {
  setTimeout(() => console.log("таймер", i), i * 10);
}

таймер 1
таймер 2
таймер 3

const cart = [
  { name: "Чай", price: 15 },
  { name: "Нон", price: 4 },
  { name: "Плов", price: 35 },
];

function cheapest(items) {
  return items.sort((a, b) => a.price - b.price)[0];
}

console.log(cheapest(cart).name);
console.log(cart.map((i) => i.name).join(", "));

Нон
Чай, Нон, Плов

const grid = new Array(3).fill([]);
grid[0].push("A1");
grid[2].push("C1");
console.log(grid.map((row) => row.length).join(","));

const state = { user: "Али", tags: ["js"] };
const copy = { ...state };
copy.tags.push("git");
console.log(state.tags.join(","));

1,0,1
js

Муфассалтар хонед: learn.javascript.ru — мураттабсозии sort(fn), MDN — Array.prototype.sort.

09 ЗС: commit-ҳо, тавсифи PR ва савол дар бораи хато

1. Commit ва тавсифи PR аз рӯи diff

Баромади git diff --staged-ро нусха кунед ва аз ЗС хоҳиш намоед, ки паёмро таҳия кунад. Бе контекст ӯ «update files» менависад:

Дар ҷавоб чиро санҷидан лозим:

• Навъ ба ҳақиқат мувофиқ аст: feat ё fix, на «ба эҳтимол».
• Дар матн он чизе нест, ки дар diff нест (ЗС «самаранокиро беҳтар кардам» илова карданро дӯст медорад, дар ҳоле ки шумо ба он даст назадаед).
• Паём мушаххас аст: онро аз санҷишҳои вазифаҳои 5.3 ва 9.2 гузаронед.
• Агар дар diff ду андешаи гуногун бошад, беҳтар аст ба ду commit тақсим кунед, на ин ки аз ЗС хоҳиш намоед «зебо муттаҳид кунад».

2. Хато: ба ҷои «кор намекунад» — мисоли ҳадди ақали такроршаванда

Мисоли ҳадди ақали такроршаванда (minimal reproducible example, MRE) — кӯтоҳтарин коде, ки хато дар он ҳанӯз намоён аст. Чӣ тавр онро ба даст овардан:

1. Ҷойи мушкилдорро ба файли алоҳида ё ба консол дар ҳамин саҳифа нусха кунед.
2. Ҳар чизи зиёдатиро порча-порча хориҷ кунед: услубҳо, функсияҳои ҳамсоя, майдонҳои зиёдатӣ. Пас аз ҳар қадам санҷед, ки хато ҷой дорад.
3. Маълумоти оддиро ҷойгузин кунед ба ҷои дархостҳо ба сервер: массиви 2–3 унсур.
4. Сабт кунед натиҷаи интизоршаванда ва воқеӣ, ҳамчунин матни хаторо калима ба калима.

Бонус: то шумо кодро содда мекардед, аксар вақт худатон хаторо меёбед. Ин муқаррарӣ ва хеле қиматнок аст. Усул «мурғобича» (rubber duck) ном дорад: мушкилро бо овози баланд чунон возеҳ шарҳ додан, ки ҷавоб худаш пайдо шавад.

Ба варақаи кӯмакии промптҳо ду сатри ин дарсро илова кунед — «Commit-ҳо ва pull request» ва «Хато ба ҷои „кор намекунад“». Ҳарду маҳоратро бо код машқ мекунем.

function bugPrompt(bug) {
  // сатрро аз сатрҳо баргардонед:
  // Баг: ожидаю «…», получаю «…».
  // Минимальный код:
  // <код>
  // Ошибка в консоли: …
  // Дай 3 гипотезы причины по вероятности.
}

console.log(bugPrompt({
  expected: "45",
  actual: "NaN",
  code: "const prices = [20, 25];\nlet sum = 0;\nfor (let i = 0; i <= prices.length; i++) sum += prices[i];\nconsole.log(sum);",
}));
console.log("---");
console.log(bugPrompt({ expected: "Привет, Али", actual: "Привет, undefined", code: "greet({ nam: 'Али' })", error: "ошибки нет" }));

Баг: ожидаю «45», получаю «NaN».
Минимальный код:
const prices = [20, 25];
let sum = 0;
for (let i = 0; i <= prices.length; i++) sum += prices[i];
console.log(sum);
Ошибка в консоли: нет
Дай 3 гипотезы причины по вероятности.
---
Баг: ожидаю «Привет, Али», получаю «Привет, undefined».
Минимальный код:
greet({ nam: 'Али' })
Ошибка в консоли: ошибки нет
Дай 3 гипотезы причины по вероятности.

const generic = ["stuff", "things", "changes", "bug", "bugs", "code", "files"];

function isVague(msg) {
  // 1) навъро хориҷ кунед: msg.replace(/^\w+(\([^)]*\))?:\s*/, "")
  // 2) калимаҳоро ҳисоб кунед ва generic-ро санҷед
  return false;
}

const ai = [
  "feat: add order filters",
  "update",
  "fix: bug",
  "chore: bump deps",
  "fix: update stuff",
  "docs: describe setup steps",
];
ai.forEach((m) => console.log(`${m} -> ${isVague(m) ? "vague" : "ok"}`));

feat: add order filters -> ok
update -> vague
fix: bug -> vague
chore: bump deps -> ok
fix: update stuff -> vague
docs: describe setup steps -> ok

10 Амал дар дарс: кор дар ҷуфтҳо

Ҳадаф: давраи пурраи кори гурӯҳиро гузаштан — шоха → PR → ревью → merge — ва се хатои ҷойгузоршударо дар лоиҳаи ҳамкор ёфтан. Дар ҷуфтҳо кор мекунем: донишҷӯи А ва донишҷӯи Б. Нишондиҳанда оид ба вақт барои 90 дақиқа: омодагӣ 10, давра бо PR 35, низоъ 10, шикори хатоҳо 25, таҳлил 10.

Қисми 1. Репозиторий ва нақшҳо (10 дақиқа)

1. Донишҷӯи А дар GitHub репозиторийи pair-shop-ро (бо README) эҷод мекунад ва дар Settings → Collaborators Б-ро даъват менамояд. Б даъватро дар почта қабул мекунад.
2. Ҳарду репозиторийро clone мекунанд:
   Терминал

   git clone https://github.com/ЛОГИН_А/pair-shop.git
   cd pair-shop

3. Мувофиқа кунед, ки шумо чӣ мекунед: А — функсияи calcTotal ва discount-ро, Б — намоиши сабадро. Ҳар кас дар файли худ кор мекунад.

Қисми 2. Шоха, commit-ҳо, PR (35 дақиқа)

1. Ҳар кас шохаи худро эҷод мекунад: А — feature/calc-total, Б — feature/cart-view.
2. Дар шоха ҳадди аққал се commit созед, ҳар кадом — як андеша, паёмҳо аз рӯи Conventional Commits:
   Терминал

   git add cart.js
   git commit -m "feat: add calcTotal"
   git add cart.js
   git commit -m "feat: add 10 percent discount"
   git add README.md
   git commit -m "docs: describe cart module"

3. Шохаро фиристед ва pull request-ро дар GitHub кушоед. Дар тавсиф — се бахш: «Что сделано», «Зачем», «Как проверить». Ревьюер — ҳамкор.
   Терминал

   git push -u origin feature/calc-total

4. Ревью: PR-и ҳамкорро аз рӯи чек-листи қисми 3 бихонед. Ҳадди аққал ду шарҳ ба сатрҳои мушаххас гузоред: яке бо савол, яке бо пешниҳод. Коди шохаро иҷро кунед.
5. Муаллиф ба шарҳҳо ҷавоб медиҳад ва кодро бо commit-ҳои нав дар ҳамон шоха ислоҳ мекунад. Ревьюер Approve-ро пахш мекунад.
6. Муаллиф Merge pull request-ро пахш мекунад. Баъд ҳарду main-ро навсозӣ мекунанд:
   Терминал

   git switch main
   git pull
   git branch -d feature/calc-total

Қисми 3. Низои қасдӣ (10 дақиқа)

1. Ҳарду шохаҳои навро аз main-и тоза эҷод мекунанд ва як сатри ягонаро дар README (масалан, сарлавҳа) — гуногун тағйир медиҳанд.
2. А PR-и худро аввал медарорад. Б дар шохаи худ git pull origin main мекунад — низоъ пайдо мешавад.
3. Б низоъро якҷоя бо А ҳал мекунад (дар бораи матни ниҳоӣ мувофиқа мекунанд), git add, git commit, git push мекунад. PR-и Б навсозӣ шуд ва дигар низоъ надорад.

Қисми 4. Се хатои ҷойгузоршуда (25 дақиқа)

Ҳар кас пинҳонӣ ба лоиҳаи худ се хатои навъҳои гуногун (аз харитаи қисми 8) ворид мекунад ва ба шохаи нави bugs/номҳо push мекунад. Ҳамкор онҳоро бо усули қисми 7 ислоҳ мекунад: такрор кардан, хаторо хондан, breakpoint ё логро гузоштан, ислоҳро бо commit-и алоҳидаи fix: … бо сабаб анҷом додан. Версияи тамринии чунин лоиҳа — вазифаи зер: онро ҳамчун ревьюи коди бегона бихонед.

const products = [
  { id: 1, name: "Курс Frontend", price: 450 },
  { id: 2, name: "Футболка MakeFirstStep", price: 80 },
  { id: 3, name: "Блокнот", price: 20 },
];

function calcTotal(items) {
  let sum = 0;
  for (let i = 1; i < items.length; i++) {
    sum += items[i].price;
  }
  return sum;
}

function priceWithDiscount(items) {
  const total = calcTotal(items);
  return total > 500 ? total * 0.9 : total;
}

function withDelivery(items) {
  items.push({ id: 0, name: "Доставка", price: 15 });
  return items;
}

const cart = [products[0], products[1], products[2]];
const cart500 = [products[0], { id: 9, name: "Стикеры", price: 50 }];

console.log(calcTotal(cart));
console.log(priceWithDiscount(cart));
console.log(priceWithDiscount(cart500));
console.log(calcTotal(withDelivery(cart)));
console.log(cart.length);

550
495
450
565
3

11 Вазифаи хонагӣ

Репозиторийро тавре ороиш диҳед, ки нишон додани он ба корфармо шармовар набошад, ва се хаторо бо таҳлили сабаб ёбед. Метавонед лоиҳаи яке аз дарсҳои гузашта (масалан, лоиҳаи хурди №1) ё лоиҳаи ҷуфтро гиред.

Қисми 1. Репозиторий

1. Репозиторий дар GitHub оммавӣ аст, номи бомаъно ва тавсиф дорад.
2. Дар таърих ҳадди аққал 10 commit-и бомаъно аз рӯи Conventional Commits: ҳар кадом — як андеша, ягон «update», «fix», «final» нест. Таърихро бо фармони git log --oneline санҷед.
3. Ҳадди аққал як шоха ба ҷуз main ва pull request-и даровардашуда бо тавсиф (чӣ анҷом шуд, барои чӣ, чӣ тавр санҷидан) ҳаст. Агар танҳо кор кунед, PR-ро аз шохаи худ ба main кушоед ва diff-ро мисли ревьюер худатон бинед.
4. Дар реша .gitignore ҳаст (ҳадди аққал: node_modules/, .env, .DS_Store, *.log) ва дар репозиторий файлҳои партов нестанд.
5. Дар реша README.md аз рӯи қолаби зер ҳаст.

# Название проекта

Одно предложение: что это и для кого.

## Что умеет
- функция 1
- функция 2

## Как запустить
1. Склонируйте репозиторий
2. Откройте index.html в браузере (или npm install && npm run dev)

## Скриншот
![скриншот](screenshot.png)

## Что я использовал
HTML, CSS, JavaScript, Git/GitHub

## Автор
Имя, группа курса

Қисми 2. Се хато

1. Дар лоиҳаи худ ё бегона се хатои воқеии навъҳои гуногун-ро ёбед: масалан, off-by-one, муқоисаи нодуруст, мутатсия, хатои тартиби коди ғайримуттаҳид. Агар наёфтед — онҳоро худатон ба нусхаи лоиҳа ворид кунед ва аз шахси шинос хоҳиш кунед, ки ёбад.
2. Барои ҳар хато commit-и алоҳидаи fix: … бо ислоҳ созед.
3. Дар репозиторий файли BUGS.md-ро эҷод кунед ва ҳар хаторо аз рӯи қолаби зер тасвир намоед.
4. Яке аз се таҳлилро бо промпт ба ЗС дар формати «мисоли ҳадди ақали такроршаванда» ҳамроҳ кунед ва ҷавоби ЗС-ро якҷоя бо баҳои худатон ба файл гузоред: чӣ бо иҷро тасдиқ шуд, ва чӣ нодуруст баромад.

## Баг 1: итоговая сумма корзины меньше правильной

- **Симптом:** ожидал 550, получил 530.
- **Как воспроизвести:** добавить три товара и посмотреть сумму.
- **Причина:** цикл начинался с i = 1 и пропускал первый товар (off-by-one).
- **Как нашёл:** поставил breakpoint в calcTotal, увидел, что цикл идёт с индекса 1.
- **Исправление:** коммит `a1b2c3d` — `fix: count first item in total`.
- **Как не допустить снова:** проверять границы цикла на массиве из 1 и 0 элементов.

Чӣ супурдан лозим

• Истинод ба репозиторийи оммавии GitHub.
• Истинод ба pull request-и даровардашуда.
• Дар репозиторий: README.md, .gitignore, BUGS.md.

Чӣ тавр баҳо медиҳем (0–10)