에러 백과

@for에 사용한 컬렉션을 순회할 수 없음

@for 루프는 배열이나 Map, Set, 제너레이터 같이 이터러블 프로토콜을 구현한 값을 순회합니다. 이 오류는 전달한 값이 어느 쪽에도 해당하지 않을 때 발생합니다. 대표적인 예가 일반 객체입니다.

@Component({
  template: `@for (item of items; track item) {
    {{ item }}
  }`,
})
class Test {
  items = {first: 'a', second: 'b'};
}

null과 undefined는 오류를 일으키지 않고 빈 컬렉션처럼 처리됩니다. 루프 본문은 렌더링되지 않으며, @empty 블록이 있으면 그 블록을 표시합니다. 따라서 이 오류는 값이 있지만 그 값을 순회할 수 없을 때만 발생합니다.

오류 해결

일반 객체의 항목을 순회하려면 KeyValue 파이프를 사용하세요.

@Component({
  imports: [KeyValuePipe],
  template: `@for (item of items | keyvalue; track item.key) {
    {{ item.key }}: {{ item.value }}
  }`,
})
class Test {
  items = {first: 'a', second: 'b'};
}

API 호출이나 다른 동적 소스에서 컬렉션을 가져온다면 목록 자체가 전달되는지 확인하세요. {data: [...]}와 같이 객체로 목록을 감싼 응답을 그대로 전달하면 이 오류가 발생할 수 있습니다.