Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
주제:
작성 대상:
개발자
mbox 요청 또는 오퍼가 실패하거나 성공하는 경우를 알려주는 at.js custom events에 대한 정보입니다.
이전에 mbox.js(사용 중단됨)에서는 페이지에서 실행되는 다른 JavaScript 코드가 백그라운드에서 발생하는 상황을 알지 못했습니다. at.js가 발전하면서 이 문제를 해결할 수 있는 기회가 생겼습니다.
고객에 따르면, 다음을 포함하여 알림을 받기 원하는 몇 가지 시나리오가 있습니다.
시간 초과, 잘못된 상태 코드, JSON 구문 분석 오류 등으로 인해 mbox 요청이 실패한 경우
mbox 요청이 성공한 경우
mbox 요소 누락, 선택기를 찾을 수 없음 등으로 인해 오퍼 렌더링이 실패한 경우
오퍼 렌더링이 성공한 경우 DOM 변경 사항이 적용된 경우
사전 정의된 이벤트에는 이벤트 유형에 따라 필수 데이터를 추출할 수 있는 구조가 있습니다.
다른 시나리오에서 이벤트를 사용할 수 있게 하도록 사용자 정의 이벤트에는 이벤트 개체(핸들러에 전달)의 detail 속성에 지정된 페이로드 개체가 있습니다. 또한 문자열을 이벤트 이름으로 전달하지 않도록 하기 위해 adobe.target.event 네임스페이스를 사용하여 이벤트가 상수로 표시됩니다.
구조
키
유형
설명
유형
문자열
at.js와의 상호 작용을 추적, 디버깅 및 사용자 지정하는 데 도움이 되도록 알림을 받으려는 몇 가지 시나리오가 있습니다.
아래에 나열된 각 사용자 지정 이벤트는 "상수" 및 "문자열 값"의 두 가지 형식을 갖습니다.
상수: 앞에 adobe.target.event.를 추가하고, 모두 대문자로 표시하고 밑줄 문자를 포함합니다. at.js가 로드된 후, mbox 응답이 수신되기 전에 사용자 지정 이벤트에 가입하려면 상수를 사용하십시오.
문자열 값: 소문자로 나타내고 대시를 포함합니다. at.js가 로드되기 전 에 사용자 지정 이벤트에 가입하려면 문자열 값을 사용하십시오.
요청이 실패했습니다
상수: adobe.target.event.REQUEST_FAILED
문자열 값: at-request-failed
설명: 시간 초과, 잘못된 상태 코드, JSON 구문 분석 오류 등으로 인해 mbox 요청이 실패했습니다.
요청 성공
상수: adobe.target.event.REQUEST_SUCCEEDED
문자열 값: at-request-succeeded
설명: mbox 요청이 성공했습니다.
컨텐츠 렌더링 실패
상수: adobe.target.event.CONTENT_RENDERING_FAILED
문자열 값: at-content-rendering-failed
설명: mbox 요소 누락, 선택기를 찾을 수 없음 등으로 인해 오퍼 렌더링이 실패했습니다.
설명: 이 이벤트는 at.js가 완전히 로드된 시간을 추적하는 데 이상적입니다. 이 이벤트를 사용하여 글로벌 mbox 실행을 사용자 지정할 수 있습니다. 또한 이 이벤트를 사용하여 글로벌 mbox를 비활성화한 후 이 이벤트를 수신하여 나중에 글로벌 mbox를 실행할 수도 있습니다.
요청 시작
상수: adobe.target.event.REQUEST_START
문자열 값: at-request-start
설명: 이 이벤트는 HTTP 요청이 실행되기 전에 시작됩니다. 리소스 시간 설정 API를 사용하는 성능 측정에 이 이벤트를 사용할 수 있습니다.
컨텐츠 렌더링 시작
상수: adobe.target.event.CONTENT_RENDERING_START
문자열 값: at-content-rendering-start
설명: 이 이벤트는 선택기 폴링이 시작되고 컨텐츠가 페이지로 렌더링되기 전에 시작됩니다. 이 이벤트를 사용하여 컨텐츠 렌더링 진행 상태를 추적할 수 있습니다.
