Коли фронтенд звертається до бекенду, мобільний додаток завантажує каталог товарів через REST API, а мікросервіси обмінюються станами у фоні, їм потрібен легкий, однозначний і машиночитаний формат передачі даних. Сьогодні цим стандартом де-факто є JSON (JavaScript Object Notation).
Попри назву, яка відсилає до синтаксису об’єктів у JavaScript, JSON є незалежним від мови програмування текстовим форматом. Його нативно підтримують Python, PHP, JavaScript/Node.js, Go, C#, Rust та більшість сучасних СУБД (PostgreSQL, MySQL, MariaDB) завдяки вбудованим типам і функціям для роботи з JSON.
Основні правила та типи даних JSON
Синтаксис JSON навмисно зроблений мінімалістичним і суворим, щоб уникнути неоднозначності під час парсингу на різних платформах:
- Пари «ключ – значення»: Об’єкти записуються у фігурних дужках
{}, де кожен ключ обов’язково береться у подвійні лапки"key": value, а пари розділяються комами. - Масиви (Arrays): Упорядковані списки значень у квадратних дужках
[], наприклад["read", "write", "deploy"]. - Підтримувані типи значень: Рядки (лише у подвійних лапках
"..."), числа (цілі та з плаваючою точкою, без ведучих нулів), булеві значення (true/false),null, а також вкладені об’єкти та масиви. - Жодних коментарів і «висячих» ком: Стандартний JSON не підтримує коментарі (
//або/* */) та кому після останнього елемента об’єкта чи масиву – це призведе до помилки парсингу.
Порівняльний аналіз: JSON проти XML та YAML
| Критерій | JSON | XML | YAML |
|---|---|---|---|
| Читабельність для людини | Висока (компактна та зрозуміла структура). | Середня (багато відкривальних і закривальних тегів). | Дуже висока (мінімум пунктуації, акцент на відступах). |
| Розмір та швидкість парсингу | Компактний payload, швидкий парсинг у браузерах та серверах. | Більший обсяг тексту через теги, важчий парсинг. | Компактний, але чутливий до відступів та складніший у парсингу. |
| Типізація та структури | Об’єкти, масиви, рядки, числа, булеві значення, null. |
Текстові вузли, атрибути, схеми валідації (XSD). | Словники, списки, скаляри, якорі та посилання. |
| Типові сценарії | REST / JSON API, веб-додатки, конфіги (package.json), поля в БД. |
SOAP, корпоративний документообіг, фіди/схеми даних. | Конфігурації CI/CD, Docker Compose, Kubernetes, Ansible. |
Практичні приклади: структура JSON, JavaScript та PHP
Приклад коректного JSON-документа
{
"service": "deploy-runner",
"version": 2,
"enabled": true,
"maintenanceWindow": null,
"targets": ["web-node-1", "web-node-2"],
"limits": {
"maxConcurrency": 4,
"timeoutSec": 30
}
}
Серіалізація та парсинг у JavaScript
Для перетворення JSON-рядка на об’єкт використовується JSON.parse(), а для зворотної серіалізації об’єкта у рядок – JSON.stringify():
const rawResponse = '{"status":"ok","items":3}';
// Парсинг рядка у JS-об'єкт (обов'язково огортайте у try/catch для ненадійних даних)
try {
const data = JSON.parse(rawResponse);
console.log(data.items); // 3
} catch (err) {
console.error('Невалідний JSON:', err.message);
}
// Серіалізація об'єкта у форматований рядок
const payload = { action: 'purge_cache', scope: ['css', 'js'] };
const jsonString = JSON.stringify(payload, null, 2);
Робота з JSON у PHP (json_encode та json_decode)
У PHP для кодування та декодування JSON рекомендується передавати прапорці безпеки й контролю помилок (наприклад, JSON_THROW_ON_ERROR та JSON_UNESCAPED_UNICODE):
<?php
$payload = [
'title' => 'Оновлення конфігурації',
'active' => true,
'roles' => ['admin', 'editor'],
];
try {
$json = json_encode($payload, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
$decoded = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
echo $decoded['title']; // Оновлення конфігурації
} catch (JsonException $e) {
error_log('Помилка JSON: ' . $e->getMessage());
}
Технічна порада розробника: Ніколи не довіряйте вхідним JSON-даним без валідації та безпечного парсингу: у JavaScript виклик
JSON.parse()на пошкодженому рядку кидає винятокSyntaxErrorі може зупинити виконання скрипта, якщо не обгорнути його вtry...catch. Крім того, якщо ви віддаєте JSON через HTTP, завжди встановлюйте заголовокContent-Type: application/json; charset=utf-8, а у PHP при рендерингу даних усередині HTML використовуйтеJSON_HEX_TAG | JSON_HEX_AMP, щоб уникнути XSS-вразливостей через послідовність</script>.