Метод GET: загрузка каталога
Как клиент, сервер и база данных обмениваются данными на примере загрузки каталога интернет-магазина.
О продукте
BB Food — интернет-магазин продуктов с доставкой на дом. Покупатель открывает сайт, смотрит каталог, выбирает продукты и оформляет заказ.
Сейчас в каталоге 7 товаров. Прежде чем тестировать сайт, разберёмся, как он устроен: что происходит в браузере, что на сервере и где хранятся товары.
Начнём с главного: как устроено почти любое веб-приложение.
Давай разбираться!
В нём две стороны. Клиент — это то, чем пользуется человек: браузер или мобильное приложение. Сервер — программа на другом компьютере, которая работает круглосуточно и слушает запросы. Клиент просит — сервер отвечает.
Браузер покупателя отправляет запрос «дай список товаров», а программа на другом компьютере на него отвечает. Кто из них клиент, а кто сервер?
Слушай, а откуда сервер берёт данные?
Сервер хранит данные в базе данных. Это отдельная программа, часто даже на отдельном компьютере. Клиент к базе напрямую не ходит: с ней общается только сервер.
Сервер и база тоже обмениваются запросами, но на своём языке — SQL.
А как они вообще понимают друг друга?
У них свой особый язык — протокол HTTP. Он самый распространённый, но бывают и другие. Клиент отправляет запрос, сервер возвращает ответ. И у запроса, и у ответа строгий формат. Вот как выглядит запрос. На самом деле частей у запроса бывает больше, но не всё сразу — начнём с простого варианта из двух частей:
Запрос
GET /api/v1/products
- Часть 1. Метод — что сделать.
GETзначит «получить». Бывают и другие методы — о них поговорим позже - Часть 2. Адрес — с чем.
/api/v1/products— это список товаров
Понятно! А что сервер присылает в ответ?
Ответ в простом варианте тоже состоит из двух частей:
Ответ
200 OK
[
{
"id": 1,
"name": "Бананы, 1 кг",
"price": 1.49
},
{
"id": 2,
"name": "Помидоры черри, 250 г",
"price": 2.29
},
…
]- Часть 1. Код статуса — как всё прошло.
200 OKзначит «успешно» - Часть 2. Тело ответа (response body) — сами данные, обычно в формате JSON
Проверим, всё ли понятно. Откуда клиент получает список товаров?
Подожди, а что такое JSON?
JSON — это простой текстовый формат, в котором программы передают друг другу данные. Его легко прочитать и человеку, так что тестировщик видит его постоянно. JSON — не единственный такой формат, бывают и другие, но начнём с него: он встречается чаще всего.
Самый простой вариант — объект. Он записывается в фигурных скобках { } и состоит из пар «ключ: значение».
Ключ — название поля в кавычках. Значение — текст в кавычках или число без кавычек. Пары разделяются запятыми.
Вот так выглядит один товар:
{
"id": 3,
"name": "Молоко 2,5 %, 1 л",
"price": 1.19
}Читается просто: у товара id 3, название «Молоко 2,5 %, 1 л», цена 1.19. Обрати внимание: в JSON дробные числа пишут через точку.
Давай потренируемся. Сервер прислал такой объект. Какая цена у этого товара?
{
"id": 4,
"name": "Сыр гауда, 200 г",
"price": 2.99
}А если товаров много, как тогда?
Тогда объекты складывают в список — его ещё называют массивом. Список записывается в квадратных скобках [ ], а объекты внутри разделены запятыми. Именно так сервер присылает наш каталог:
[
{"id": 1, "name": "Бананы, 1 кг", "price": 1.49},
{"id": 2, "name": "Помидоры черри, 250 г", "price": 2.29}
]Если товаров нет вовсе, придёт пустой список []. Это не ошибка, а просто «данных нет» — запомни, это нам ещё пригодится.
Вопрос на внимательность: сколько товаров в этом ответе?
[
{"id": 1, "name": "Бананы, 1 кг", "price": 1.49},
{"id": 5, "name": "Ржаной хлеб", "price": 1.79},
{"id": 6, "name": "Апельсиновый сок, 1 л", "price": 2.49}
]Ура, давай попробуем на практике!
Вот сайт BB Food. Пока товары на нём не отображаются: браузер ещё ничего не запрашивал у сервера.
Твоя задача сейчас: нажми «Загрузить товары» и проследи путь конверта: клиент → сервер → база данных → сервер → клиент.
Тестируемое приложение
Сценарий 1. Позитивный: сервер работает
Сервер ждёт запросов. Нажми «Загрузить товары» в браузере, чтобы клиент отправил запрос GET /api/v1/products.
Анимация замедлена: в реальности весь путь занимает десятки миллисекунд.
Товары ещё не загружены.
Не удалось загрузить товары: на сервере произошла ошибка (500). Попробуйте позже.
Товары загрузились! Но они не живут в браузере: они хранятся в базе данных на стороне сервера, и клиент каждый раз получает их через запрос.
Ой, а можно загрузить товары ещё раз?
Да, конечно. Запрос пройдёт тот же путь: клиент → сервер → база данных → сервер → клиент. Но ответ всегда показывает актуальное состояние базы: если товары поменялись, придёт уже другой ответ.
Интересно! А как товары выглядят в базе?
Хороший вопрос! В базе данные лежат в таблицах. Наши товары — в таблице products. Одна строка — один товар, один столбец — одно свойство товара: id — уникальный номер, name — название, price — цена.
Когда приходит запрос GET /api/v1/products, сервер выполняет SQL-запрос SELECT * FROM products. Он значит «выбери все столбцы всех строк из таблицы products». Потом сервер превращает строки в JSON и отправляет клиенту.
Вот как выглядит таблица products в базе данных:
| id | name | price |
|---|---|---|
| 1 | Бананы, 1 кг | 1.49 |
| 2 | Помидоры черри, 250 г | 2.29 |
| 3 | Молоко 2,5 %, 1 л | 1.19 |
| 4 | Сыр гауда, 200 г | 2.99 |
| 5 | Ржаной хлеб | 1.79 |
| 6 | Апельсиновый сок, 1 л | 2.49 |
| 7 | Селёдка, 300 г | 3.29 |
И запомни: клиент никогда не ходит в базу сам. С базой общается только сервер.
Сравни товары на сайте с этой таблицей: все ли дошли до клиента?
Покупатель нажимает «Загрузить товары» пять раз подряд. Что произойдёт с товарами в базе данных?
Позитивный сценарий разобрали. Идём дальше?
Да, поехали дальше!
Сценарий 2. Негативный: ошибка сервера
Итак, позитивный сценарий мы проверили: сервер работает, товары дошли до клиента. Но тестировщика всегда интересует другое: а что, если что-то пошло не так? Например, на сервере случилась поломка. Как думаешь, что тогда увидит пользователь?
Хм, даже не представляю. Давай проверим!
Представим, что на сервере что-то сломалось.
Твоя задача сейчас: нажми «Загрузить товары» на сайте ниже и посмотри, что произойдёт.
Сервер работает и отвечает, но вместо товаров вернул ошибку 500: внутри сервера что-то сломалось. Обрати внимание: ответ пришёл, и в нём есть код. Все коды, которые начинаются с 5, — это ошибки на стороне сервера: пользователь ни в чём не виноват, чинить надо сервер.
Запомни: 500 — это ответ сервера «у меня что-то сломалось». Коды, которые начинаются с 4, наоборот, говорят, что ошибся клиент: например, запросил то, чего нет.
А что мне тут проверять и зачем?
Хороший вопрос! Тестировщик проверяет не только то, что работает, когда всё хорошо, но и то, как приложение ведёт себя при сбое. Проверь три вещи: пользователь видит понятное сообщение об ошибке, а не технический код или пустой экран, приложение не зависает, а кнопку можно нажать ещё раз. Зачем? Серверы ломаются, и пользователь не должен теряться, когда это случается.
Сообщить разработчикам об ошибке
Разработчики починили сервер. Ура! Хорошо, что всё снова работает, и мы можем продолжать тестирование.
Твоя задача сейчас: нажми «Загрузить товары» — теперь запрос должен пройти успешно.
Отлично, всё работает! Но давай пока немного отдохнём — пошли пить кофе ☕
Пошли!
Справка по теме
Клиент
Программа, которой пользуется человек: браузер, мобильное приложение. Клиент показывает интерфейс, а за данными обращается к серверу.
Сервер
Программа, которая постоянно слушает входящие запросы, обрабатывает их и отправляет ответ. Сам сервер никому не пишет первым: он только отвечает на запросы клиентов.
База данных
Хранилище, в котором данные лежат в таблицах. Клиент не обращается к базе напрямую: с ней работает только сервер.
Запрос и ответ
Клиент и сервер общаются по протоколу HTTP. Запрос содержит метод (что сделать) и адрес (с чем). Ответ содержит код статуса (как всё прошло) и тело с данными, чаще всего в формате JSON.
JSON
Текстовый формат данных. Объект пишут в фигурных скобках { } парами «ключ: значение», например {"id": 3, "price": 1.19}. Текст — в кавычках, числа — без кавычек. Список объектов пишут в квадратных скобках [ ] через запятую. Пустой список [] значит «данных нет», а не ошибка.
Метод GET и код 200
GET /api/v1/products означает «получить данные». Он ничего не меняет на сервере, поэтому его можно повторять сколько угодно раз. Код 200 OK означает, что запрос выполнен успешно.
Код 500
Ответ, который сервер присылает, когда у него самого что-то сломалось. Коды на 5 — ошибки сервера, коды на 4 — ошибки клиента. Тестировщик проверяет, что пользователь видит понятное сообщение об ошибке, а приложение не зависает.