--- title: "로케이터에 권장되는 HTML 속성" slug: "preferred-html-attribute-locator" updated: 2025-12-01T05:59:54Z published: 2025-12-01T05:59:54Z canonical: "helpcenter.autify.com/preferred-html-attribute-locator" --- > ## Documentation Index > Fetch the complete documentation index at: https://helpcenter.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # 로케이터에 권장되는 HTML 속성 ## 로케이터란? 로케이터(Locator)는 웹 페이지 상의 조작이나 어설션(Assertion)의 대상이 되는 요소(버튼, 입력 폼, 링크 등)를 다른 요소와 구별하여 고유하게 식별하기 위한 메커니즘입니다. Autify Nexus에서는 레코딩 시 요소의 계층적 위치를 나타내는 CSS 선택자나 XPath에 더해, 속성 정보(role, text, 커스텀 속성 등)를 이용하여 대상 요소를 특정하는 로케이터를 생성합니다. ### 기능 개요 이 기능은 로케이터를 생성할 때 사용자가 지정한 HTML 속성을 우선적으로 사용할 수 있도록 하는 기능입니다. 설정할 수 있는 속성은 `class`나 `id`와 같은 표준 HTML 속성뿐만 아니라, 커스텀 속성(`data-*` 등)도 지정 가능합니다. 이를 통해 테스트 대상 애플리케이션이 독자적인 속성을 가지고 있는 경우나 표준 HTML 속성을 주로 사용하는 경우에도, 구현 상황에 맞춰 최적의 로케이터를 생성할 수 있게 됩니다. ## 이용 순서 1. 내비게이션 바의 **설정** 아이콘을 클릭합니다. 2. **녹화 및 로컬 실행 설정** 섹션에 있는 **고급 설정** 버튼을 클릭하여 상세 설정을 펼칩니다. 3. **로케이터에 권장되는 HTML 속성** 입력 필드에 사용하려는 HTML 속성명을 입력합니다. (예: `data-w-id`, `data-qa`) ![](https://cdn.document360.io/c040854c-2c75-49d0-98e1-43f462e8657e/Images/Documentation/image(202).png?sv=2026-02-06&spr=https&st=2026-11-16T22%3A45%3A23Z&se=2026-11-16T23%3A45%3A23Z&sr=b&sp=r&sig=bfvSl81M65neYbKNV20187Rbc4cq6CEMn2E3TqNWHXs%3D) 4. **완료** 버튼을 클릭하여 설정을 저장합니다. ## 유의 사항 - 지정한 속성이 페이지 내 여러 요소에 동일한 값으로 존재하거나, 지정한 속성이 요소에 존재하지 않는 경우 기존의 로케이터 생성 로직이 사용됩니다. - 설정 변경 후 새로 레코딩할 때 적용됩니다. 기존 시나리오의 로케이터는 변경되지 않습니다. - 설정은 다른 기기나 사용자 간에 공유되지 않습니다. ## 참고 [HTML 속성 레퍼런스 - HTML | MDN](https://developer.mozilla.org/ko/docs/Web/HTML/Attributes)