خواندن قالب از فرانت¶
هر پاسخ سطح بالای یکسانی دارد، پس کلاینت یک تایپ، یک تابع fetch و یک صفحهبند لازم دارد. مثالها TypeScript است، ولی شکل از هر زبانی یکی است.
تایپها¶
type Page =
| { type: 'page'; count: number; page: number; pages: number; page_size: number;
has_next: boolean; has_previous: boolean }
| { type: 'cursor'; next_cursor: string | null; previous_cursor: string | null;
page_size: number; has_next: boolean; has_previous: boolean };
type Success<T> = { success: true; status_code: number; message: string; data: T;
pagination?: Page };
type Failure = { success: false; status_code: number; message: string; error_code: string;
data: { fields?: Record<string, { code: string; message: string }[]> }
& Record<string, unknown> };
type Envelope<T> = Success<T> | Failure;
اگر پروژه از اسکیما استفاده میکند، اینها را از آن بسازید: اسکیما قالب را توصیف میکند، پس تایپهای ساختهشده همینها هستند.
یک تابع fetch¶
async function ask<T>(path: string, init: RequestInit = {}): Promise<Envelope<T>> {
const response = await fetch(`${API}${path}`, {
...init,
headers: { 'Content-Type': 'application/json',
'Accept-Language': currentLanguage(), // the messages in the reader's language
...init.headers },
});
return response.json(); // always the envelope
}
const answer = await ask<Product>('/products/1/');
if (answer.success) {
show(answer.data);
} else if (answer.error_code === 'out_of_stock') { // branch on the code, never the message
offer(answer.data.available as number);
} else {
toast(answer.message); // a person reads the message
}
یک صفحهبند برای هر دو نوع¶
function nextQuery(page: Page): Record<string, string> | null {
if (!page.has_next) return null;
return page.type === 'page'
? { page: String(page.page + 1) }
: { cursor: page.next_cursor! };
}
has_next در هر دو نوع هست، پس «بیشتر» روی لیست شمارهدار و فید یکسان کار
میکند.
خطاهای یک فرم¶
if (!answer.success && answer.error_code === 'validation_error') {
for (const [field, problems] of Object.entries(answer.data.fields ?? {})) {
markField(field, problems[0].message); // "items.0.quantity" for a nested one
}
}
problems[0].code - required، max_length، unique - به کلاینت میگوید چه
اشتباهی شده، بدون اینکه متن ترجمهشده را بخواند.