---
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`)
.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)