AI 개발 · 실무
웹 서비스 해부도 - 서버·백엔드·프런트엔드·보안 구성요소 실무
프런트엔드 구성 - 렌더링 방식·정적 자산·성능
서버 렌더링·클라이언트 렌더링·정적 생성 비교, 정적 자산 버전 붙이기와 캐시, 이미지 크기·지연 로딩, 첫 화면 속도 지표의 뜻, 접근성 점검, 완성 코드는 HTML 문서를 분석해 무거운 자원·빠진 대체 텍스트·버전 없는 자산을 보고
개발자KR · 원고 갱신
이 장에서 배우는 것
온라인 서점에서 독자가 책 상세 페이지를 열면 제목과 가격, 표지, 책 소개가 한 화면에 놓인다. 제목과 가격을 담은 HTML을 어디서 만들지, 표지를 어느 크기로 보낼지, 수정한 스타일을 어떻게 다시 받게 할지는 각각 다른 결정이다. 앞 장에서 캐시로 데이터 조회를 줄였다면, 여기서는 브라우저에 도착하는 문서와 정적 자산을 살펴본다. 정적 자산은 요청마다 내용을 계산할 필요 없이 파일로 제공할 수 있는 스타일시트, 스크립트, 이미지 등을 말한다.
- 서버 렌더링, 클라이언트 렌더링, 정적 생성에서 본문 HTML이 만들어지는 시점을 구분한다.
- 파일 내용에 따라 자산 URL을 바꾸고, HTML과 자산의 캐시 정책을 정한다.
- 이미지의 전송 크기와 표시 크기를 구분하고, 첫 화면과 화면 아래의 이미지 로딩 방식을 정한다.
- 첫 화면의 속도 지표를 해석하고 키보드 조작과 이미지 대체 텍스트를 점검한다.
- Python으로 HTML과 로컬 자산을 검사하고, AI가 제안한 수정을 실행 결과와 변경 내역으로 검토한다.
문제 상황
서점에서 새 책 《밤의 지도》를 등록했다. 상세 페이지의 제목과 가격은 바로 나오지만, 표지가 한참 뒤에 나타나면서 아래에 있던 책 소개가 밀린다. 운영자가 스타일시트를 수정한 뒤에는 처음 방문한 독자와 다시 방문한 독자가 서로 다른 화면을 본다. 키보드로 페이지를 둘러보던 독자는 현재 어느 링크에 초점이 있는지 알아보기 어렵다고 알려 왔다.
우선 받은 HTML과 화면이 완성된 뒤의 상태를 구분해 확인한다. 받은 HTML에 제목과 가격이 들어 있다면, 그 내용을 보여 주기 위해 별도의 스크립트가 데이터를 받아 올 필요는 없다. 표지가 늦는 원인을 좁히려면 표지 URL을 브라우저가 언제 발견하는지, 실제로 몇 바이트를 받는지, 이미지가 오기 전에 표시 공간이 확보되는지를 각각 본다. 새 스타일이 안 보이는 문제는 현재 HTML이 가리키는 URL과 브라우저가 그 URL로 받은 응답을 확인한다. 초점 문제는 마우스에서 손을 떼고 직접 재현한다.
이 장의 프로그램은 그중 소스와 로컬 파일로 판정할 수 있는 항목을 맡는다. 자산의 파일 크기, 이미지의 alt 속성 유무, 서점에서 정한 파일명 버전 규칙을 보고한다. 어느 항목을 고칠지 판단할 때는 화면에서 자원이 맡은 역할도 함께 본다.
본문 HTML을 만드는 위치와 시점
서버 렌더링(server-side rendering)은 상세 페이지 요청을 받은 서버가 책 데이터를 읽고 본문 HTML을 만들어 응답하는 방식이다. 브라우저는 받은 문서에서 제목과 가격을 읽고, 문서에 참조된 표지와 스타일시트를 받기 시작할 수 있다. 가격을 요청 시점의 데이터로 표시하기 쉽지만, 서버의 데이터 조회와 템플릿 처리 시간이 응답에 포함된다. HTML 응답을 공유 캐시에 보관한다면 가격 변경이 반영되는 시점도 함께 정해야 한다.
클라이언트 렌더링(client-side rendering)에서는 브라우저가 스크립트를 실행해 화면을 구성한다. 예를 들어 처음 받은 HTML에는 화면을 붙일 자리만 있고, 스크립트가 책 데이터를 받아 제목과 가격을 채운다. 검색 조건을 자주 바꾸는 탐색 화면에서는 필요한 부분만 갱신하기 편하다. 본문에 필요한 스크립트와 데이터가 늦게 도착하면 독자는 그만큼 본문을 기다린다. 데이터를 불러오는 중과 불러오기에 실패했을 때의 화면도 구현해야 한다.
정적 생성(static generation)은 배포 전에 책 데이터를 읽어 상세 페이지 HTML을 파일로 만들어 두는 방식이다. 요청이 오면 이미 만들어 둔 파일을 응답한다. 내용이 자주 바뀌지 않는 기획전 소개에 적용하기 쉽다. 가격까지 파일에 넣으면 원본 가격을 바꾼 뒤 해당 페이지를 다시 생성하고 배포할 때 화면의 가격이 바뀐다. 갱신 주기를 정할 때는 페이지 생성에 걸리는 시간과 독자에게 이전 값이 노출될 수 있는 시간을 함께 고려한다.
| 방식 | 본문을 만드는 때 | 서점에서의 적용 예 | 확인할 항목 |
|---|---|---|---|
| 서버 렌더링 | 서버가 페이지 요청을 처리할 때 | 현재 가격을 담는 책 상세 페이지 | 응답 HTML의 제목과 가격, 서버 응답 대기 시간 |
| 클라이언트 렌더링 | 브라우저에서 스크립트가 실행될 때 | 필터를 연속해서 바꾸는 책 탐색 화면 | 데이터를 기다리는 동안과 로드 실패 시의 화면 |
| 정적 생성 | 배포용 파일을 만들 때 | 내용이 오래 유지되는 기획전 소개 | 원본을 수정한 뒤 새 페이지가 배포되는 시점 |
한 페이지에도 여러 방식을 조합할 수 있다. 상세 페이지의 제목, 가격, 표지는 서버에서 HTML로 보내고, 독자가 배송 지역을 고른 뒤에 표시되는 예상 배송일은 브라우저에서 갱신할 수 있다. 방식을 고를 때는 페이지 이름보다 각 정보가 처음 필요한 시점과 바뀌는 빈도를 본다. 완성 화면만으로는 서버 렌더링과 정적 생성을 구분하기 어려우므로, 빌드에서 파일을 만드는지 요청 처리에서 템플릿을 실행하는지도 확인한다.
정적 자산의 URL과 이미지 로딩
파일 내용이 바뀌면 URL도 바꾼다
스타일시트를 /assets/layout.css로 배포하고 오랫동안 캐시하도록 설정했다고 하자. 같은 URL의 파일만 교체하면 기존 응답을 아직 신선하다고 판단한 브라우저는 이전 스타일을 재사용할 수 있다. 파일 바이트에서 계산한 해시를 이름에 넣으면 새 파일을 다른 URL로 제공할 수 있다. 예를 들어 layout.9f2a31bc.css를 고친 뒤 새 해시가 붙은 파일을 배포하고, HTML도 새 파일을 가리키도록 갱신한다.
같은 URL의 내용을 유지하는 버전 자산에는 긴 신선도 기간을 줄 수 있다. 공개 자산이라면 응답의 Cache-Control을 public, max-age=31536000, immutable처럼 설정하는 방법이 있다. max-age는 응답을 신선하게 재사용할 수 있는 기간을 초 단위로 나타낸다. immutable은 그 기간 안에 내용이 바뀌지 않는다는 뜻이다. 새 자산을 가리키는 공개 HTML에는 no-cache를 적용해 저장된 응답을 재사용하기 전에 서버에 재검증하도록 할 수 있다. 새 자산을 먼저 올리고 HTML을 나중에 갱신한다. 이전 HTML을 제공하거나 이전 배포로 되돌릴 수 있는 기간에는 그 HTML이 참조하는 파일도 남겨 둔다.
이 장의 검사기는 서점의 파일명 규칙으로, 확장자 바로 앞에 점과 소문자 16진수 여덟 자리가 있는지 본다. 쿼리 문자열에 붙인 버전은 이 파일명 규칙에 포함되지 않는다. 파일명 검사를 통과해도 실제 파일과 해시가 맞는지는 빌드 단계에서 확인해야 한다. 예제에서는 해시의 앞 여덟 자리를 쓰며, 같은 이름에 서로 다른 내용이 대응하는 경우 배포 단계에서 충돌을 감지해야 이전 URL의 내용을 유지할 수 있다.
표시 공간과 전송량을 따로 관리한다
서점 표지를 화면에 폭 240픽셀로 그려도 원본 이미지가 크면 브라우저는 여전히 그 원본을 받을 수 있다. 표시 폭에 맞는 후보 파일을 만들고 srcset에 후보들의 실제 픽셀 너비를, sizes에 화면 조건에 따른 예상 표시 폭을 적으면 브라우저가 화면과 기기에 맞는 후보를 선택할 수 있다. width와 height에는 이미지 비율을 나타내는 치수를 함께 적는다. 브라우저는 이 비율을 사용해 이미지를 받기 전에도 표시 공간을 잡을 수 있다. 가변 폭 레이아웃에서는 스타일로 표시 폭을 조정하고 높이가 비율에 맞게 변하도록 한다.
첫 화면에서 독자가 바로 볼 대표 표지는 HTML에서 일찍 발견하게 하고 지연 로딩을 생략한다. 아래로 내려가야 나타나는 추천 도서 표지에는 loading="lazy"를 적용할 수 있다. 브라우저가 화면과의 거리를 고려해 요청 시점을 정하므로 정확히 화면에 들어온 순간에만 받는다는 뜻은 아니다. 같은 이미지라도 페이지 배치가 바뀌어 첫 화면에 들어오면 로딩 설정을 다시 검토한다.
첫 화면 속도와 접근성 점검
최대 콘텐츠 렌더링 시간(Largest Contentful Paint, LCP)은 탐색 시작부터 뷰포트에 있는 가장 큰 콘텐츠 후보가 그려질 때까지의 시간을 나타낸다. 상세 페이지에서는 대표 표지나 큰 제목이 후보가 될 수 있다. 표지가 후보라면 문서 응답을 기다리는 시간, 표지 요청을 시작하기까지의 시간, 파일을 받는 시간, 받은 뒤 그리기까지의 시간을 나누어 살펴본다. 파일을 줄여도 스크립트가 늦게 표지를 삽입하는 구조라면 요청 시작 시점부터 확인해야 한다.
누적 레이아웃 이동(Cumulative Layout Shift, CLS)은 예상치 않게 화면 배치가 움직인 정도를 나타낸다. 단위가 없는 점수이며, 크기가 정해지지 않은 표지 아래에서 소개 문단이 밀리는 현상이 한 예다. 다음 페인트까지의 상호작용 지연(Interaction to Next Paint, INP)은 클릭이나 키 입력 같은 상호작용에서 브라우저가 다음 화면을 그릴 때까지 얼마나 기다리는지 보여 준다. 검색 필터를 눌렀을 때 긴 스크립트 작업으로 선택 표시가 늦는 상황에서 볼 수 있다. 첫 화면이 그려지는 속도, 화면 배치의 안정성, 입력 후 반응 속도를 각각 확인하면 수정할 위치를 좁힐 수 있다.
수정 전후를 비교할 때는 같은 뷰포트와 네트워크 조건에서 페이지를 열고, 처음 방문하는 경우와 자산을 이미 받은 경우를 구분해 기록한다. 표지가 후보 요소인지 확인한 뒤 전송 크기나 로딩 설정을 한 번에 하나씩 바꾼다. 추천 도서까지 스크롤해 지연 로딩 뒤에도 공간이 유지되는지 확인하고, 검색 필터처럼 실제로 쓰는 조작을 수행해 입력 반응을 살핀다. 로컬 파일의 크기는 전송량을 줄일 후보를 찾는 데 쓰인다. 실제 응답의 압축과 캐시 상태, 브라우저의 그리기 시간은 별도로 확인한다.
접근성은 코드를 읽고 화면을 직접 조작하는 두 단계로 확인한다. 이미지가 독자에게 전달하는 정보가 있으면 그 역할에 맞는 대체 텍스트를 제공한다. 예를 들어 표지만 있는 상세 페이지 링크라면 이미지의 대체 텍스트에서 링크 목적을 알 수 있어야 한다. 같은 링크 안에 책 제목이 이미 있고 이미지가 같은 정보를 반복한다면 alt=""를 쓸 수 있다. 속성 누락을 찾은 뒤에는 빈 값이 적절한지, 문구가 주변 텍스트를 불필요하게 반복하는지도 읽어 본다.
브라우저에서 탭 키와 역방향 탭으로 링크와 버튼을 순회한다. 각 위치에서 초점 표시가 보이는지, 순서가 읽는 흐름과 맞는지, 링크를 엔터 키로 열고 버튼을 엔터 키나 스페이스 키로 조작할 수 있는지 확인한다. 페이지를 확대해도 제목, 가격, 조작 요소를 읽고 사용할 수 있는지 살핀다. 화면 낭독기로 제목 구조와 링크 이름을 훑어 보면 같은 이름의 링크가 서로 다른 책을 가리키는 문제도 찾을 수 있다.
완성 코드
다음 내용을 main.py로 저장한다. 프로그램은 임시 디렉터리에 서점 상세 페이지와 자산을 만들고, HTML을 다시 읽어 검사한 뒤 종료한다. 테스트 표지는 회색 픽셀을 담은 유효한 비압축 BMP 파일이다. 표시 크기는 작지만 파일이 검사 기준을 넘도록 만들어 전송 크기와 표시 크기의 차이를 확인한다. 기본 검사 기준은 이 예제에서 정한 자산당 24,000바이트다.
from hashlib import sha256
from html.parser import HTMLParser
from pathlib import Path, PurePosixPath
import re
import struct
from tempfile import TemporaryDirectory
from urllib.parse import unquote, urlsplit
HTML = """<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>밤의 지도 | 작은 서점</title>
<link rel="stylesheet" href="/assets/{css_name}">
<script src="/assets/shelf.js" defer></script>
</head>
<body>
<main>
<h1>밤의 지도</h1>
<p>12,000원</p>
<img src="/assets/night.bmp" width="96" height="128">
<p>밤길을 걸으며 그린 도시의 기록이다.</p>
<h2>추천 도서</h2>
<p>
<a href="/books/river.html">
<img src="/assets/{badge_name}" width="12" height="12"
loading="lazy" alt="">
강가의 노트
</a>
</p>
</main>
</body>
</html>
"""
VERSIONED_NAME = re.compile(r".+\.[0-9a-f]{8}\.[^.]+")
SIZE_LIMIT = 24_000
class AssetParser(HTMLParser):
def __init__(self):
super().__init__(convert_charrefs=True)
self.references = []
def handle_starttag(self, tag, attributes):
attrs = dict(attributes)
line, _ = self.getpos()
if tag == "img":
self.references.append((line, attrs.get("src"), "alt" not in attrs))
elif tag == "script" and attrs.get("src"):
self.references.append((line, attrs["src"], False))
elif tag == "link":
rel = (attrs.get("rel") or "").lower().split()
if "stylesheet" in rel and attrs.get("href"):
self.references.append((line, attrs["href"], False))
def local_asset(root, url):
parts = urlsplit(url)
if parts.scheme or parts.netloc:
return None
path = PurePosixPath(unquote(parts.path))
if path.parts[:2] != ("/", "assets") or ".." in path.parts:
return None
assets = (root / "assets").resolve()
candidate = root.joinpath(*path.parts[1:]).resolve()
if not candidate.is_relative_to(assets):
return None
return candidate
def audit(html_file, size_limit=SIZE_LIMIT):
parser = AssetParser()
parser.feed(html_file.read_text(encoding="utf-8"))
parser.close()
findings = []
counted = set()
for line, url, missing_alt in parser.references:
if missing_alt:
findings.append(f"대체 텍스트 누락 | {line}행 | {url or '(src 없음)'}")
if not url:
continue
asset = local_asset(html_file.parent, url)
if asset is None or asset in counted:
continue
counted.add(asset)
label = asset.relative_to(html_file.parent.resolve()).as_posix()
if not asset.is_file():
findings.append(f"파일 없음 | {label}")
continue
size = asset.stat().st_size
if size > size_limit:
findings.append(f"크기 초과 | {label} | {size:,}바이트")
if VERSIONED_NAME.fullmatch(asset.name) is None:
findings.append(f"파일명 버전 없음 | {label}")
return findings
def write_versioned(folder, stem, suffix, data):
digest = sha256(data).hexdigest()[:8]
name = f"{stem}.{digest}.{suffix}"
(folder / name).write_bytes(data)
return name
def gray_bmp(width, height):
row = b"\x88\x88\x88" * width
row += b"\x00" * (-len(row) % 4)
pixels = row * height
file_header = struct.pack("<2sIHHI", b"BM", 54 + len(pixels), 0, 0, 54)
image_header = struct.pack(
"<IiiHHIIiiII", 40, width, height, 1, 24, 0, len(pixels), 0, 0, 0, 0
)
return file_header + image_header + pixels
def main():
with TemporaryDirectory() as directory:
root = Path(directory)
assets = root / "assets"
assets.mkdir()
css_name = write_versioned(
assets, "layout", "css", b"body { max-width: 42rem; margin: auto; }\n"
)
badge_name = write_versioned(assets, "badge", "bmp", gray_bmp(12, 12))
(assets / "night.bmp").write_bytes(gray_bmp(96, 128))
(assets / "shelf.js").write_bytes(b"document.documentElement.dataset.ready = 'yes';\n")
html_file = root / "book.html"
html_file.write_text(
HTML.format(css_name=css_name, badge_name=badge_name),
encoding="utf-8",
)
findings = audit(html_file)
print(f"서점 상세 페이지 검사 | 기준 {SIZE_LIMIT:,}바이트")
for finding in findings:
print(finding)
print(f"보고 항목 {len(findings)}건")
if __name__ == "__main__":
main()
줄별 해설
HTML의{css_name}과{badge_name}에는 실제 생성한 파일명이 들어간다. 표지는 누락된alt와 버전 없는 파일명으로 검사에 걸리도록 두었다. 추천 링크에는 책 제목이 있으므로 장식용 이미지의alt를 빈 값으로 지정했다.AssetParser.handle_starttag()는 시작 태그마다 호출된다.getpos()의 첫 번째 값은 태그가 시작하는 행이다. 이미지에서는 속성 딕셔너리에alt키가 있는지 보므로 누락과alt=""를 구분한다. 스타일시트 링크는rel을 공백으로 나눈 뒤 판정한다.local_asset()은 URL을 나눠 경로 부분을 얻고, 문서가 참조하는/assets/파일을 임시 디렉터리 안에서 찾는다. 쿼리와 조각 식별자는 로컬 파일을 찾는 데 사용하지 않는다. URL에 스킴이나 호스트가 있으면 건너뛰며, 경로를 정규화한 뒤에도 자산 디렉터리 안에 있는지 확인한다.audit()은 대체 텍스트 누락을 이미지 태그마다 확인한다. 같은 파일을 여러 태그가 참조해도 크기와 버전은 정규화된 파일 경로를 기준으로 한 번만 검사한다. 파일이 없으면 경로를 보고하고 다음 참조로 넘어간다.size > size_limit이므로 제한과 같은 크기의 파일은 통과한다. 파일명은 정규식 전체 일치로 검사한다.write_versioned()는 파일로 쓸 바이트에서 이름을 계산한다.gray_bmp()는 24비트 비압축 픽셀을 만든다. 픽셀 하나에 세 바이트를 쓰고 각 행을 네 바이트 경계에 맞춘다. 표지는 행당 288바이트, 총 128행이며 헤더 54바이트를 더해 36,918바이트가 된다.main()은 파일을 모두 쓴 뒤 HTML을 다시 열어 검사한다. 결과는 태그를 읽은 순서대로 출력한다. 임시 디렉터리 경로는 출력에 넣지 않으며, 실행이 끝나면 임시 파일은 정리된다. 이 검사에서 자산 참조는 이미지의src, 스크립트의src, 스타일시트의href로 범위를 정했다. 반응형 이미지 후보나 CSS 안의 참조를 검사하려면 그 문법도 처리해야 한다.
실행 결과
저장한 파일이 있는 디렉터리에서 다음 명령을 실행한다. 출력의 14행은 문서에서 표지 태그가 시작하는 위치다.
python3 main.py
서점 상세 페이지 검사 | 기준 24,000바이트
대체 텍스트 누락 | 14행 | /assets/night.bmp
크기 초과 | assets/night.bmp | 36,918바이트
파일명 버전 없음 | assets/night.bmp
파일명 버전 없음 | assets/shelf.js
보고 항목 4건
추천 링크의 장식용 이미지는 빈 대체 텍스트를 명시했으므로 누락 건수에 들어가지 않는다. 스타일시트와 장식용 이미지의 파일명에는 버전이 들어 있다. 표지의 세 항목은 서로 독립적이다. 파일명에 버전을 붙인 뒤에도 크기와 대체 텍스트는 따로 고쳐야 한다.
실무에서 자주 틀리는 것
아래 Python 조각은 같은 디렉터리의 main.py를 가져와 브라우저에 보낼 HTML이나 파일명을 만드는 차이를 보여 준다.
내용을 바꾸면서 캐시된 파일명을 계속 쓰는 경우
다음 코드는 스타일을 수정할 때마다 같은 파일에 저장한다. 배포한 HTML이 같은 URL을 계속 가리키면 이전 응답을 재사용하는 브라우저가 생길 수 있다.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as directory:
path = Path(directory) / "layout.css"
path.write_bytes(b"body { margin: 2rem; }\n")
print(f'<link rel="stylesheet" href="/assets/{path.name}">')
고친 코드는 저장한 바이트로 파일명을 만들고 그 이름을 HTML에 넣는다. 파일 생성과 참조 갱신이 같은 이름을 공유한다.
from pathlib import Path
from tempfile import TemporaryDirectory
from main import write_versioned
with TemporaryDirectory() as directory:
name = write_versioned(
Path(directory), "layout", "css", b"body { margin: 2rem; }\n"
)
print(f'<link rel="stylesheet" href="/assets/{name}">')
첫 화면 표지에 지연 로딩을 붙이고 치수를 생략하는 경우
다음 표지는 화면 맨 위에 배치한다고 가정한다. 지연 로딩 때문에 브라우저가 표지 요청을 늦출 수 있고, 치수도 없어 이미지가 도착할 때 공간이 생기면서 책 소개가 밀릴 수 있다.
print(
'<img src="/assets/night.bmp" loading="lazy" '
'alt="가로등 아래 골목을 그린 표지">'
)
대표 표지는 지연 로딩을 생략하고 이미지 비율에 맞는 두 치수를 적는다. 표시 공간을 잡은 뒤에도 파일이 크다면 압축하거나 필요한 해상도의 파일을 만들어 별도로 전송량을 줄인다.
print(
'<img src="/assets/night.bmp" width="96" height="128" '
'alt="가로등 아래 골목을 그린 표지">'
)
빈 대체 텍스트와 속성 누락을 같은 조건으로 검사하는 경우
다음 조건은 빈 문자열도 거짓으로 판정한다. 책 제목이 같은 링크 안에 있는 장식용 이미지까지 누락으로 보고한다.
attrs = {"src": "/assets/badge.bmp", "alt": ""}
print("대체 텍스트 누락" if not attrs.get("alt") else "속성 있음")
누락 검사는 키가 있는지 확인한다. 이 코드가 속성 있음을 출력하면, 이어서 사람이 문맥을 보고 빈 값이 적절한지 판단한다.
attrs = {"src": "/assets/badge.bmp", "alt": ""}
print("대체 텍스트 누락" if "alt" not in attrs else "속성 있음")
한눈에 보기
| 변경 지점 | 결정할 내용 | 점검 방법 |
|---|---|---|
| 본문 HTML | 생성 시점과 가격 갱신 시점 | 받은 HTML과 생성 경로를 살피고 가격 변경이 반영되는지 확인한다. |
| 정적 자산 | 내용 기반 URL과 캐시 기간 | 파일을 수정해 새 URL을 얻고, 갱신된 HTML과 실제 응답 헤더를 확인한다. |
| 이미지 | 후보 크기, 표시 비율, 지연 로딩 대상 | 실제로 선택된 파일과 전송 크기를 보고, 로딩 중에 공간이 유지되는지 관찰한다. |
| 속도와 접근성 | 첫 주요 콘텐츠, 배치 안정성, 입력 반응, 키보드 조작 | 브라우저에서 같은 조건으로 측정하고 키보드와 화면 낭독기로 둘러본다. |
AI에 수정을 맡길 때는 파일과 화면의 역할, 합격 조건을 함께 적는다. 예를 들어 다음과 같이 요청할 수 있다.
서점 상세 페이지의 대표 표지는 첫 화면에, 추천 표지는 아래에 있다. 대표 표지는 HTML에서 바로 발견할 수 있게 하고 이미지 비율을 유지하라. 추천 이미지와 같은 링크에 책 제목이 있으면 장식용 이미지에 빈 대체 텍스트를 사용하라. 수정 전후 HTML의 변경 내역과 로컬 검사 결과, 브라우저에서 직접 확인할 항목을 제시하라.
| 맡길 작업 | 요청에 넣을 조건 | 받은 결과를 확인하는 방법 |
|---|---|---|
| 렌더링 변경 | 받은 상세 페이지 HTML에서 제목과 가격을 읽을 수 있게 한다. | 응답 HTML을 읽고, 데이터 조회 실패 시에 보이는 화면도 확인한다. |
| 자산 버전 적용 | 내용이 같은 파일은 같은 이름을 쓰고, 내용을 바꾸면 HTML 참조도 갱신한다. | 같은 입력으로 두 번 생성하고, 한 바이트를 바꿔 파일명과 HTML의 변경 내역을 대조한다. |
| 표지와 추천 이미지 수정 | 대표 표지는 일찍 요청할 수 있게 하고, 장식용 이미지는 주변 제목과 중복해서 읽히지 않게 한다. | 프로그램을 실행해 경고의 증감을 확인하고, 브라우저의 요청 순서와 링크 이름을 직접 확인한다. |
| 검사기 변경 | 속성 누락과 빈 값을 구분하고, 같은 파일의 크기 경고는 한 번만 출력한다. | 누락된 태그와 빈 값 태그를 넣어 테스트하고, 변경 내역에서 기존 판정 조건도 확인한다. |
다음 장에서는 상세 페이지에서 이어지는 로그인과 주문 화면을 바탕으로, 누가 요청했는지 확인하는 일과 그 요청을 허용할지 판단하는 일을 살펴본다.
연습 문제
- 책 소개는 거의 바뀌지 않고 가격은 하루에도 여러 번 바뀐다. 상세 페이지의 첫 HTML에 현재 가격을 담으려면 어떤 렌더링 방식을 적용할 수 있는가. 소개만 담은 기획전 페이지에는 어떤 다른 방식을 적용할 수 있는가.
- 새 스타일시트에 내용 기반 이름을 붙였지만 일부 사용자는 여전히 이전 스타일을 본다. HTML과 자산의 배포 순서 및 HTML의 캐시 정책에서 확인할 항목을 적어 보라.
- 완성 코드의
SIZE_LIMIT를 36,918로 바꾸고, 표지의<img>에alt="밤길을 그린 표지"를 추가하라. 실행했을 때 남는 보고 항목과 이유를 예상한 뒤 확인하라. - AI가 모든 이미지에 지연 로딩을 추가하고
width와height를 삭제했다. 대표 표지가 첫 화면의 가장 큰 요소라면 영향을 받을 수 있는 두 지표를 고르고, 수정 전후에 무엇을 비교할지 적어 보라.
정답과 해설
상세 페이지는 서버 렌더링으로 요청 시점에 읽은 가격을 HTML에 담을 수 있다. 응답에 캐시를 적용한다면 가격이 바뀐 뒤 재사용될 수 있는 기간을 함께 확인한다. 소개만 담은 기획전은 정적 생성으로 제공하고 소개가 바뀔 때 다시 생성해 배포할 수 있다.
먼저 독자가 받은 HTML에서 스타일시트 URL을 확인한다. 이전 URL이면 저장된 HTML을 바로 재사용하는지, 서버나 배포 경로에서 아직 이전 문서를 응답하는지 본다. 새 URL이면 그 파일이 실제로 배포됐고 올바른 내용을 응답하는지 확인한다. 배포에서는 새 자산을 먼저 올리고 새 HTML을 제공하며, 공개 HTML은 재사용 전에 재검증하도록 설정할 수 있다.
파일명 버전 없음 | assets/night.bmp와파일명 버전 없음 | assets/shelf.js가 남아 2건이 된다. 표지 크기는 기준과 같고, 코드는 기준을 넘는 경우만 보고한다. 표지에는alt속성이 생겼으며 두 파일의 이름은 그대로다.대표 표지 요청이 늦어지면 LCP가 늘 수 있다. 치수 삭제로 표지 아래의 요소가 밀리면 CLS가 커질 수 있다. 같은 뷰포트에서 대표 표지 요청 시작 시각, LCP의 후보 요소와 기록 시각, 표지가 나타날 때 이동한 요소를 비교한다. 변경 내역에서 대표 표지의 지연 로딩을 제거하고 비율에 맞는 치수를 복원한 뒤 다시 측정한다.
READER FEEDBACK
질문·의견
내용에 관한 질문이나 더 나은 설명을 위한 의견을 남겨 주세요. 오탈자는 위의 제보 양식이 더 빨리 반영됩니다. 이 댓글은 원래 게시글과 같은 자리에 쌓입니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.