Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

database package

Firebase 실시간 데이터베이스

함수

함수	설명
function(앱, ...)
getDatabase(앱, URL)	제공된 FirebaseApp과 연결된 실시간 데이터베이스 SDK의 인스턴스를 반환합니다. 인스턴스가 없거나 기존 인스턴스가 커스텀 데이터베이스 URL을 사용하는 경우 기본 설정으로 새 인스턴스를 초기화합니다.
함수(db, ...)
connectDatabaseEmulator(db, host, port, options)	실시간 데이터베이스 에뮬레이터와 통신하도록 제공된 인스턴스를 수정합니다. 참고: 이 메서드는 다른 작업을 수행하기 전에 호출해야 합니다.
go오프라인(db)	서버와의 연결을 해제합니다. 모든 데이터베이스 작업이 오프라인으로 완료됩니다.클라이언트는 데이터베이스 서버에 대한 영구 연결을 자동으로 유지합니다. 이러한 연결은 무기한 활성 상태로 유지되며 연결이 끊어지면 다시 연결됩니다. 그러나 영구 연결이 바람직하지 않은 경우 `goOffline()` 및 `goOnline()` 메서드를 사용하여 클라이언트 연결을 제어할 수 있습니다.오프라인 상태에서는 클라이언트가 더 이상 데이터베이스에서 데이터 업데이트를 수신하지 않습니다. 그러나 로컬에서 수행된 모든 데이터베이스 작업은 계속해서 이벤트를 즉시 발생시키므로 애플리케이션이 계속 정상적으로 작동할 수 있습니다. 또한 로컬에서 수행한 각 작업은 자동으로 대기열에 추가되고 데이터베이스 서버에 다시 연결되면 재시도됩니다.데이터베이스에 다시 연결하고 원격 이벤트 수신을 시작하려면 `goOnline()`를 참고하세요.
goOnline(DB)	서버에 다시 연결하고 오프라인 데이터베이스 상태를 서버 상태와 동기화합니다.이 메서드는 `goOffline()`와의 활성 연결을 사용 중지한 후에 사용해야 합니다. 다시 연결되면 클라이언트는 적절한 데이터를 전송하고 적절한 이벤트를 실행하여 클라이언트가 '따라잡습니다'. 자동으로 확장 및 축소할 수 있습니다
ref(db, path)	데이터베이스에서 제공된 경로에 해당하는 위치를 나타내는 `Reference`를 반환합니다. 경로를 입력하지 않으면 `Reference`가 데이터베이스의 루트를 가리킵니다.
refFromURL(db, url)	제공된 Firebase URL에 해당하는 데이터베이스의 위치를 나타내는 `Reference`를 반환합니다.URL이 유효한 Firebase 데이터베이스 URL이 아니거나 현재 `Database` 인스턴스와 다른 도메인을 갖는 경우 예외가 발생합니다.모든 쿼리 매개변수 (`orderBy`, `limitToLast` 등)는 무시되며 반환된 `Reference`에 적용되지 않습니다.
함수()
forceLongPolling()	Websockets 대신 longPolling을 강제로 사용합니다. databaseURL에 Websocket 프로토콜이 사용된 경우 무시됩니다.
forceWebSockets()	longPolling 대신 WebSocket을 강제로 사용합니다.
orderByKey()	키를 기준으로 정렬하는 새 `QueryConstraint`를 만듭니다.쿼리 결과를 (오름차순) 키 값을 기준으로 정렬합니다.`orderByKey()`에 대한 자세한 내용은 데이터 정렬을 참조하세요.
orderByPriority()	우선순위에 따라 정렬하는 새 `QueryConstraint`를 만듭니다.애플리케이션에서 우선순위를 사용할 필요는 없지만 일반 속성별로 컬렉션을 정렬할 수 있습니다 (우선순위 대신 데이터 정렬 참고).
orderByValue()를 호출합니다.	값에 따라 정렬하는 새 `QueryConstraint`를 만듭니다.쿼리의 하위 요소가 모두 스칼라 값 (문자열, 숫자 또는 불리언)인 경우 결과를 (오름차순) 값에 따라 정렬할 수 있습니다.`orderByValue()`에 대한 자세한 내용은 데이터 정렬을 참조하세요.
serverTimestamp()에 대해 자세히 알아보세요.	Firebase 서버에서 결정된 현재 타임스탬프 (Unix 에포크 이후의 시간, 밀리초)를 자동으로 입력하기 위한 자리표시자 값을 반환합니다.
함수(델타, ...)
증분(델타)	제공된 델타만큼 현재 데이터베이스 값을 원자적으로 증분하는 데 사용할 수 있는 자리표시자 값을 반환합니다.
function(사용 설정됨, ...)
enableLogging(사용 설정됨, 영구)	콘솔에 디버깅 정보를 로깅합니다.
function(limit, ...)
limitToFirst(limit)	첫 번째 특정 하위 요소 수로 제한되는 경우 새 `QueryConstraint`를 만듭니다.`limitToFirst()` 메서드는 지정된 콜백에서 동기화할 하위 요소의 최대 개수를 설정하는 데 사용됩니다. 제한을 100개로 설정하면 처음에 최대 100개의 `child_added` 이벤트만 수신합니다. 데이터베이스에 저장된 메시지가 100개 미만이면 메시지마다 `child_added` 이벤트가 발생합니다. 하지만 메시지가 100개를 초과하는 경우 정렬된 처음 100개의 메시지에 대해서만 `child_added` 이벤트가 수신됩니다. 상품이 변경됨에 따라 활성 목록에서 삭제된 각 상품에 대해 `child_removed` 이벤트가 수신되므로 총 개수는 100개로 유지됩니다.`limitToFirst()`에 관한 자세한 내용은 데이터 필터링을 참고하세요.
limitToLast(limit)를 사용하세요.	마지막으로 지정된 수의 하위 요소만 반환하도록 제한되는 새 `QueryConstraint`를 만듭니다.`limitToLast()` 메서드는 지정된 콜백에서 동기화할 하위 요소의 최대 개수를 설정하는 데 사용됩니다. 제한을 100개로 설정하면 처음에 최대 100개의 `child_added` 이벤트만 수신합니다. 데이터베이스에 저장된 메시지가 100개 미만이면 메시지마다 `child_added` 이벤트가 발생합니다. 하지만 메시지가 100개를 넘는 경우 정렬된 마지막 메시지 100개에 대한 `child_added` 이벤트만 수신됩니다. 상품이 변경됨에 따라 활성 목록에서 삭제된 각 상품에 대해 `child_removed` 이벤트가 수신되므로 총 개수는 100개로 유지됩니다.`limitToLast()`에 관한 자세한 내용은 데이터 필터링을 참고하세요.
function(로거, ...)
enableLogging(로거)	콘솔에 디버깅 정보를 로깅합니다.
function(parent, ...)
child(parent, path)	지정된 상대 경로에 있는 위치의 `Reference`를 가져옵니다.상대 경로는 간단한 하위 요소 이름 (예: 'ada')이거나 더 깊은 슬래시로 구분된 경로 (예: 'ada/name/first')일 수 있습니다.
push(parent, value)	고유 키를 사용하여 새 하위 위치를 생성하고 `Reference`를 반환합니다.이는 항목 컬렉션에 데이터를 추가하는 가장 일반적인 패턴입니다.`push()`에 값을 제공하면 이 값이 생성된 위치에 기록됩니다. 값을 전달하지 않으면 데이터베이스에 아무것도 기록되지 않고 하위 요소가 비어 있게 됩니다. 하지만 다른 곳에서 `Reference`를 사용할 수 있습니다.`push()`에서 생성된 고유 키는 현재 시간을 기준으로 정렬되므로 결과 항목 목록은 시간순으로 정렬됩니다. 또한 키는 추측할 수 없도록 설계되었습니다 (임의의 엔트로피 72비트 포함).데이터 목록에 추가를 참고하세요. 고유 식별자를 보장하는 2^120 방법을 참조하세요.
함수(경로, ...)
orderByChild(path)	지정된 하위 키를 기준으로 정렬하는 새 `QueryConstraint`를 만듭니다.쿼리는 한 번에 하나의 키로만 정렬할 수 있습니다. 동일한 쿼리에서 `orderByChild()`를 여러 번 호출하면 오류가 발생합니다.Firebase 쿼리를 사용하면 즉석에서 하위 키별로 데이터를 정렬할 수 있습니다. 하지만 색인을 미리 계획할 수 있다면 보안 규칙의 .indexOn 규칙을 통해 색인을 정의하여 성능을 높일 수 있습니다. 자세한 내용은 https://firebase.google.com/docs/database/security/indexing-data 규칙을 참고하세요.`orderByChild()`에 관한 자세한 내용은 데이터 정렬을 참고하세요.
function(query, ...)
get(쿼리)	이 쿼리의 최신 결과를 가져옵니다.
off(query, eventType, 콜백)	이전에 상응하는 `on()` (`onValue`, `onChildAdded`) 리스너와 연결된 콜백을 분리합니다. 참고: 이 방법은 리스너를 삭제하는 데 권장되는 방법이 아닙니다. 대신 각 `on` 콜백에서 반환된 콜백 함수를 사용하세요.이전에 `on*()`와 연결된 콜백을 분리합니다. 상위 리스너에 `off()`를 호출해도 하위 노드에 등록된 리스너가 자동으로 삭제되지 않습니다. 하위 리스너에서도 `off()`를 호출하여 콜백을 삭제해야 합니다.콜백이 지정되지 않으면 지정된 eventType의 모든 콜백이 삭제됩니다. 마찬가지로 eventType을 지정하지 않으면 `Reference`의 모든 콜백이 삭제됩니다.개별 리스너는 수신 거부 콜백을 호출하여 삭제할 수도 있습니다.
onChild추가됨(쿼리, 콜백, cancelCallback)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onChildAdded` 이벤트는 이 위치의 초기 하위 요소마다 한 번씩 트리거되며 새 하위 요소가 추가될 때마다 다시 트리거됩니다. 콜백에 전달된 `DataSnapshot`는 관련 하위 요소의 데이터를 반영합니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되고 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChild추가됨(쿼리, 콜백, 옵션)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onChildAdded` 이벤트는 이 위치의 초기 하위 요소마다 한 번씩 트리거되며 새 하위 요소가 추가될 때마다 다시 트리거됩니다. 콜백에 전달된 `DataSnapshot`는 관련 하위 요소의 데이터를 반영합니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되고 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChildAdd(쿼리, 콜백, cancelCallback, options)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onChildAdded` 이벤트는 이 위치의 초기 하위 요소마다 한 번씩 트리거되며 새 하위 요소가 추가될 때마다 다시 트리거됩니다. 콜백에 전달된 `DataSnapshot`는 관련 하위 요소의 데이터를 반영합니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되고 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChildChanged(쿼리, 콜백, cancelCallback)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목 (또는 그 하위 요소)에 저장된 데이터가 변경되면 `onChildChanged` 이벤트가 트리거됩니다. 단일 `child_changed` 이벤트는 하위 요소의 여러 변경사항을 나타낼 수 있습니다. 콜백에 전달되는 `DataSnapshot`에는 새 하위 콘텐츠가 포함됩니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수 또는 첫 번째 하위 요소인 경우 `null`도 콜백에 전달됩니다.
onChildChanged(쿼리, 콜백, 옵션)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목 (또는 그 하위 요소)에 저장된 데이터가 변경되면 `onChildChanged` 이벤트가 트리거됩니다. 단일 `child_changed` 이벤트는 하위 요소의 여러 변경사항을 나타낼 수 있습니다. 콜백에 전달되는 `DataSnapshot`에는 새 하위 콘텐츠가 포함됩니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수 또는 첫 번째 하위 요소인 경우 `null`도 콜백에 전달됩니다.
onChildChanged(쿼리, 콜백, cancelCallback, options)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목 (또는 그 하위 요소)에 저장된 데이터가 변경되면 `onChildChanged` 이벤트가 트리거됩니다. 단일 `child_changed` 이벤트는 하위 요소의 여러 변경사항을 나타낼 수 있습니다. 콜백에 전달되는 `DataSnapshot`에는 새 하위 콘텐츠가 포함됩니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수 또는 첫 번째 하위 요소인 경우 `null`도 콜백에 전달됩니다.
onChildMove(쿼리, 콜백, cancelCallback)를 호출합니다.	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.동위 요소를 기준으로 하위 요소의 정렬 순서가 변경되면 `onChildMoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 이동한 하위 요소의 데이터에 사용됩니다. 또한 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되거나 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChildMoved(쿼리, 콜백, 옵션)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.동위 요소를 기준으로 하위 요소의 정렬 순서가 변경되면 `onChildMoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 이동한 하위 요소의 데이터에 사용됩니다. 또한 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되거나 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChildMoved(query, 콜백, cancelCallback, options)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.동위 요소를 기준으로 하위 요소의 정렬 순서가 변경되면 `onChildMoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 이동한 하위 요소의 데이터에 사용됩니다. 또한 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되거나 첫 번째 하위 요소인 경우 `null`가 전달됩니다.
onChildRemoved(쿼리, 콜백, cancelCallback)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목은 삭제될 때마다 한 번씩 `onChildRemoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 삭제된 하위 요소의 이전 데이터입니다. 다음과 같은 경우 하위 요소가 삭제됩니다.- 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 명시적으로 `remove()`를 호출하고 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 `set(null)`를 호출하고 하위 요소가 모든 하위 요소를 삭제함 - 이제 하위 요소를 필터링하는 쿼리가 실행 중인 경우 (정렬 순서가 변경되었거나 최대 한도에 도달했기 때문에)
onChildRemoved(쿼리, 콜백, 옵션)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목은 삭제될 때마다 한 번씩 `onChildRemoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 삭제된 하위 요소의 이전 데이터입니다. 다음과 같은 경우 하위 요소가 삭제됩니다.- 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 명시적으로 `remove()`를 호출하고 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 `set(null)`를 호출하고 하위 요소가 모든 하위 요소를 삭제함 - 이제 하위 요소를 필터링하는 쿼리가 실행 중인 경우 (정렬 순서가 변경되었거나 최대 한도에 도달했기 때문에)
onChildRemoved(쿼리, 콜백, cancelCallback, options)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.하위 항목은 삭제될 때마다 한 번씩 `onChildRemoved` 이벤트가 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 삭제된 하위 요소의 이전 데이터입니다. 다음과 같은 경우 하위 요소가 삭제됩니다.- 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 명시적으로 `remove()`를 호출하고 클라이언트가 해당 하위 요소 또는 상위 요소 중 하나에서 `set(null)`를 호출하고 하위 요소가 모든 하위 요소를 삭제함 - 이제 하위 요소를 필터링하는 쿼리가 실행 중인 경우 (정렬 순서가 변경되었거나 최대 한도에 도달했기 때문에)
onValue(쿼리, 콜백, cancelCallback)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onValue` 이벤트는 이 위치에 저장된 초기 데이터로 한 번 트리거된 다음 데이터가 변경될 때마다 다시 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 `on()`가 호출된 위치에 관한 것입니다. 전체 콘텐츠가 동기화될 때까지 트리거되지 않습니다. 위치에 데이터가 없으면 빈 `DataSnapshot`로 트리거됩니다 (`val()`는 `null`을 반환함).
onValue(쿼리, 콜백, 옵션)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onValue` 이벤트는 이 위치에 저장된 초기 데이터로 한 번 트리거된 다음 데이터가 변경될 때마다 다시 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 `on()`가 호출된 위치에 관한 것입니다. 전체 콘텐츠가 동기화될 때까지 트리거되지 않습니다. 위치에 데이터가 없으면 빈 `DataSnapshot`로 트리거됩니다 (`val()`는 `null`을 반환함).
onValue(쿼리, 콜백, cancelCallback, options)	특정 위치의 데이터 변경사항을 수신 대기합니다.데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.`onValue` 이벤트는 이 위치에 저장된 초기 데이터로 한 번 트리거된 다음 데이터가 변경될 때마다 다시 트리거됩니다. 콜백에 전달되는 `DataSnapshot`는 `on()`가 호출된 위치에 관한 것입니다. 전체 콘텐츠가 동기화될 때까지 트리거되지 않습니다. 위치에 데이터가 없으면 빈 `DataSnapshot`로 트리거됩니다 (`val()`는 `null`을 반환함).
query(query, queryConstraints)	추가 쿼리 제약 조건도 포함하도록 확장되는 변경 불가능한 `Query` 인스턴스를 새로 만듭니다.
함수(ref, ...)
onDisconnect(참조)	`OnDisconnect` 객체를 반환합니다. 사용 방법에 관한 자세한 내용은 JavaScript에서 오프라인 기능 사용 설정을 참고하세요.
삭제(참조)	이 데이터베이스 위치에서 데이터를 삭제합니다.하위 위치의 모든 데이터도 삭제됩니다.삭제 효과가 즉시 표시되며 해당 이벤트 '값'이 트리거됩니다 제거를 Firebase 서버로 동기화하는 작업도 시작되고, 반환된 프로미스는 완료되면 해결됩니다. 제공되는 경우 동기화가 완료된 후 onComplete 콜백이 비동기식으로 호출됩니다.
runTransaction(ref, transactionUpdate, options)	이 위치의 데이터를 원자적으로 수정합니다.이 위치의 데이터를 원자적으로 수정합니다. 이전 값과 관계없이 데이터를 덮어쓰는 일반 `set()`와 달리 `runTransaction()`는 기존 값을 새 값으로 수정하여 같은 위치에 동시에 쓰는 다른 클라이언트와 충돌하지 않도록 하는 데 사용됩니다.이를 위해 `runTransaction()`에 현재 값을 새 값으로 변환하는 업데이트 함수를 전달합니다. 새 값이 기록되기 전에 다른 클라이언트가 해당 위치에 쓰기 작업을 수행하면 업데이트 함수가 새로운 현재 값으로 다시 호출되고 쓰기가 다시 시도됩니다. 이 작업은 충돌 없이 쓰기가 성공하거나 업데이트 함수에서 값을 반환하지 않아 트랜잭션을 취소할 때까지 반복적으로 발생합니다.참고: `set()`로 데이터를 수정하면 해당 위치에서 대기 중인 트랜잭션이 취소되므로 `set()`와 `runTransaction()`를 혼합하여 동일한 데이터를 업데이트하는 경우 각별한 주의를 기울여야 합니다.참고: 보안 및 Firebase 규칙이 있는 트랜잭션을 사용하는 경우 클라이언트가 트랜잭션을 실행하려면 `.write` 액세스 외에 `.read` 액세스도 필요합니다. 이는 트랜잭션의 클라이언트 측 특성으로 인해 클라이언트가 트랜잭션 방식으로 데이터를 읽기 위해 데이터를 읽어야 하기 때문입니다.
set(ref, value)	이 데이터베이스 위치에 데이터를 씁니다.이 위치 및 모든 하위 위치의 데이터를 덮어씁니다.쓰기 효과가 즉시 표시되고 해당 이벤트('value', 'child_added' 등)가 트리거됩니다. Firebase 서버와의 데이터 동기화도 시작되고 완료되면 반환된 프로미스가 해결됩니다. 제공되는 경우 동기화가 완료된 후 `onComplete` 콜백이 비동기식으로 호출됩니다.새 값에 `null`를 전달하는 것은 `remove()`를 호출하는 것과 같습니다. 즉, 이 위치의 모든 데이터와 모든 하위 위치가 삭제됩니다.`set()`을 사용하면 이 위치에 저장된 모든 우선순위가 삭제되므로 우선순위를 유지하려면 `setWithPriority()`를 대신 사용해야 합니다.`set()`로 데이터를 수정하면 해당 위치에서 대기 중인 거래가 취소되므로 `set()`와 `transaction()`를 혼합하여 동일한 데이터를 수정하는 경우 각별히 주의해야 합니다.단일 `set()`는 하나의 '값'을 생성합니다. 이벤트가 수행된 위치에서 `set()` 이벤트가 수행되었습니다.
setPriority(ref, 우선순위)	이 데이터베이스 위치에 있는 데이터의 우선순위를 설정합니다.애플리케이션에서 우선순위를 사용할 필요는 없지만 일반 속성에 따라 컬렉션을 정렬할 수 있습니다 (데이터 정렬 및 필터링 참조).
setWithPriority(ref, value, 우선순위)	데이터베이스 위치에 데이터를 씁니다. `set()`와 유사하지만 해당 데이터의 우선순위도 지정합니다.애플리케이션은 우선순위를 사용할 필요가 없지만 일반 속성에 따라 컬렉션을 정렬할 수 있습니다 (데이터 정렬 및 필터링 참고).
update(ref, values): 업데이트(참조, 값)	한 번에 여러 값을 데이터베이스에 씁니다.`values` 인수에는 데이터베이스에 함께 쓸 여러 속성-값 쌍이 포함됩니다. 각 하위 속성은 간단한 속성(예: 'name') 또는 현재 위치에서 업데이트할 데이터로의 상대 경로(예: 'name/first')일 수 있습니다.`set()` 메서드와 달리 `update()`를 사용하면 현재 위치에서 참조된 속성만 선택적으로 업데이트할 수 있습니다(현재 위치에서 모든 하위 속성을 대체하는 대신).쓰기의 효과는 즉시 표시되고 해당 이벤트는 '하위 값'으로 표시됩니다. Firebase 서버와의 데이터 동기화도 시작되고 완료되면 반환된 프로미스가 해결됩니다. 제공되는 경우 동기화가 완료된 후 `onComplete` 콜백이 비동기식으로 호출됩니다.단일 `update()`는 단일 '값'을 생성합니다. 수정된 하위 요소 수와 관계없이 `update()`가 수행된 위치에서 이벤트가 발생합니다.`update()`로 데이터를 수정하면 해당 위치에서 대기 중인 트랜잭션이 취소되므로 `update()`와 `transaction()`를 혼합하여 동일한 데이터를 수정하는 경우 각별히 주의해야 합니다.`null`를 `update()`에 전달하면 이 위치에서 데이터가 삭제됩니다.다중 위치 업데이트 소개를 참고하세요.
함수(값, ...)
endAt(값, 키)	지정된 종료 지점을 사용하여 `QueryConstraint`를 만듭니다.`startAt()`, `startAfter()`, `endBefore()`, `endAt()`, `equalTo()`를 사용하여 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.종료 지점은 포함되므로 지정된 값을 정확하게 가진 하위 항목이 쿼리에 포함됩니다. 선택적 키 인수는 쿼리 범위를 추가로 제한하는 데 사용할 수 있습니다. 지정할 경우 지정된 값을 정확하게 갖는 하위 요소도 지정된 키보다 작거나 같은 키 이름을 가져야 합니다.`endAt()`에 관한 자세한 내용은 데이터 필터링을 참조하세요.
endBefore(값, 키)	지정된 종료 지점 (제외)을 사용하여 `QueryConstraint`을 만듭니다.`startAt()`, `startAfter()`, `endBefore()`, `endAt()`, `equalTo()`를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.종료 지점은 제외됩니다. 값만 제공되는 경우 지정된 값보다 작은 값을 가진 하위 항목이 쿼리에 포함됩니다. 키가 지정된 경우 하위 요소의 값은 지정된 값보다 작거나 같아야 하고 키 이름은 지정된 키보다 작아야 합니다.
EqualTo(값, 키)	지정된 값과 일치하는 하위 요소를 포함하는 `QueryConstraint`를 만듭니다.`startAt()`, `startAfter()`, `endBefore()`, `endAt()`, `equalTo()`를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.선택적 키 인수를 사용하여 쿼리 범위를 추가로 제한할 수 있습니다. 이 속성이 지정된 경우 정확하게 지정된 값을 가진 하위 요소도 정확히 지정된 키를 키 이름으로 가져야 합니다. 동일한 값에 대해 일치하는 항목이 많은 결과 집합을 필터링하는 데 사용할 수 있습니다.`equalTo()`에 대한 자세한 내용은 데이터 필터링을 참조하세요.
startAfter(값, 키)	지정된 시작점 (제외)으로 `QueryConstraint`를 만듭니다.`startAt()`, `startAfter()`, `endBefore()`, `endAt()`, `equalTo()`를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.시작 지점은 제외됩니다. 값만 제공되는 경우 지정된 값보다 큰 값을 가진 하위 항목이 쿼리에 포함됩니다. 키가 지정된 경우 하위 요소는 지정된 값보다 크거나 같은 값과 지정된 키보다 큰 키 이름을 가져야 합니다.
startAt(값, 키)	지정된 시작점으로 `QueryConstraint`를 만듭니다.`startAt()`, `startAfter()`, `endBefore()`, `endAt()`, `equalTo()`를 사용하여 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.시작 지점은 포괄적이므로 지정된 값을 정확하게 가진 하위 항목이 쿼리에 포함됩니다. 선택적 키 인수는 쿼리 범위를 추가로 제한하는 데 사용할 수 있습니다. 지정할 경우 지정된 값을 정확하게 갖는 하위 요소도 지정된 키보다 크거나 같은 키 이름도 가져야 합니다.`startAt()`에 관한 자세한 내용은 데이터 필터링을 참고하세요.

클래스

클래스	설명
데이터베이스	Firebase 실시간 데이터베이스를 나타내는 클래스입니다.
DataSnapshot	`DataSnapshot`에는 데이터베이스 위치의 데이터가 포함됩니다.데이터베이스에서 데이터를 읽을 때마다 데이터가 `DataSnapshot`로 수신됩니다. `DataSnapshot`은 `on()` 또는 `once()`를 사용하여 연결하는 이벤트 콜백에 전달됩니다. `val()` 메서드를 호출하여 스냅샷의 콘텐츠를 JavaScript 객체로 추출할 수 있습니다. 또는 `child()`를 호출하여 하위 스냅샷을 반환하여 스냅샷으로 순회할 수 있습니다 (이후 `val()`를 호출할 수 있음).`DataSnapshot`는 데이터베이스 위치에 있는 데이터의 효율적으로 생성되고 변경할 수 없는 사본입니다. 이 메서드는 수정할 수 없으며 변경되지 않습니다. 데이터를 수정하려면 항상 `Reference`에서 `set()` 메서드를 직접 호출합니다.
연결 해제	`onDisconnect` 클래스를 사용하면 클라이언트가 데이터베이스 서버에서 연결 해제될 때 데이터를 쓰거나 삭제할 수 있습니다. 이러한 업데이트는 클라이언트의 연결이 정상적으로 해제되었는지 여부와 관계없이 발생하므로 연결이 끊어지거나 클라이언트가 비정상 종료되더라도 데이터를 정리하는 데 사용할 수 있습니다.`onDisconnect` 클래스는 연결된 클라이언트 수와 다른 클라이언트가 연결 해제되는 시점을 감지하는 데 유용한 애플리케이션의 현재 상태를 관리하는 데 가장 많이 사용됩니다. 자세한 내용은 JavaScript에서 오프라인 기능 사용 설정을 참조하세요.데이터베이스 서버로 요청이 전송되기 전에 연결이 끊어질 때 문제를 방지하려면 데이터를 쓰기 전에 이러한 함수를 호출해야 합니다.`onDisconnect` 작업은 한 번만 트리거됩니다. 연결 해제가 발생할 때마다 작업이 실행되도록 하려면 다시 연결할 때마다 `onDisconnect` 작업을 다시 설정해야 합니다.
쿼리 제약 조건	`QueryConstraint`는 데이터베이스 쿼리에서 반환하는 문서 집합의 범위를 좁히는 데 사용됩니다. `QueryConstraintQueryConstraint`
TransactionResult	runTransaction()의 확인 값의 유형입니다.

인터페이스

인터페이스	설명
데이터베이스 참조	`DatabaseReference`는 데이터베이스의 특정 위치를 나타내며 해당 데이터베이스 위치에 데이터를 읽거나 쓰는 데 사용할 수 있습니다.`ref()` 또는 `ref("child/path")`를 호출하여 데이터베이스의 루트 또는 하위 위치를 참조할 수 있습니다.쓰기는 `set()` 메서드로 실행되고 읽기는 `on*()` 메서드로 수행할 수 있습니다. https://firebase.google.com/docs/database/web/read-and-write를 참조하세요.
IteratedDataSnapshot	반복 중인 `Reference`의 하위 스냅샷을 나타냅니다. 키는 정의되지 않습니다.
ListenOptions	리스너를 맞춤설정하는 데 사용할 수 있는 옵션 객체입니다.
쿼리	`Query`는 데이터베이스 위치에서 데이터를 정렬하고 필터링하여 하위 데이터의 하위 집합만 포함합니다. 일부 속성 (예: 공룡 키)별로 데이터 컬렉션을 정렬하거나 많은 항목 목록 (예: 채팅 메시지)을 클라이언트에 동기화하기에 적합한 숫자로 제한하는 데 사용할 수 있습니다. 쿼리는 여기에 정의된 하나 이상의 필터 메서드를 함께 연결하여 생성됩니다.`DatabaseReference`와 마찬가지로 `on*()` 메서드를 사용하여 `Query`에서 데이터를 수신할 수 있습니다. 쿼리와 일치하는 데이터 하위 집합에 대한 이벤트 및 `DataSnapshot`만 수신됩니다.자세한 내용은 https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data를 참고하세요.
ThenableReference	push()에서 반환될 때 `DatabaseReference`로도 작동할 수 있는 `Promise`입니다. 참조를 즉시 사용할 수 있으며 백엔드 쓰기가 완료되면 `Promise`가 확인됩니다.
TransactionOptions	트랜잭션을 구성하는 옵션 객체입니다.

유형 별칭

별칭 입력	설명
EventType	'value', 'child_added', 'child_changes', 'child_deleted', 'child_moved' 문자열 중 하나입니다.
QueryConstraintType	이 SDK에서 사용할 수 있는 다양한 쿼리 제약조건을 설명합니다.
수신 거부	리스너를 제거하기 위해 호출할 수 있는 콜백입니다.

함수(앱, ...)

getDatabase(앱, URL)

제공된 FirebaseApp과 연결된 실시간 데이터베이스 SDK의 인스턴스를 반환합니다. 인스턴스가 없거나 기존 인스턴스가 커스텀 데이터베이스 URL을 사용하는 경우 기본 설정으로 새 인스턴스를 초기화합니다.

서명:

export declare function getDatabase(app?: FirebaseApp, url?: string): Database;

매개변수

매개변수	유형	설명
앱	Firebase 앱	반환된 실시간 데이터베이스 인스턴스와 연결된 FirebaseApp 인스턴스입니다.
url	문자열	연결할 실시간 데이터베이스 인스턴스의 URL입니다. 제공하지 않으면 SDK가 Firebase 앱의 기본 인스턴스에 연결됩니다.

반환:

데이터베이스

제공된 앱의 Database 인스턴스

함수(db, ...)

connectDatabaseEmulator(db, host, port, options)

실시간 데이터베이스 에뮬레이터와 통신하도록 제공된 인스턴스를 수정합니다.

참고: 이 메서드는 다른 작업을 수행하기 전에 호출해야 합니다.

서명:

export declare function connectDatabaseEmulator(db: Database, host: string, port: number, options?: {
    mockUserToken?: EmulatorMockTokenOptions | string;
}): void;

매개변수

매개변수	유형	설명
db	데이터베이스	수정할 인스턴스입니다.
호스트	문자열	에뮬레이터 호스트 (예: localhost)
포트	숫자	에뮬레이터 포트 (예: 8080)
옵션	{ fakeUserToken?: EmulatorMockTokenOptions \| string; }

반환:

void

go오프라인(db)

서버와의 연결을 해제합니다 (모든 데이터베이스 작업이 오프라인으로 완료됩니다).

클라이언트는 데이터베이스 서버에 대한 영구적인 연결을 자동으로 유지하며, 이 연결은 무기한으로 활성 상태로 유지되며 연결이 끊기면 다시 연결됩니다. 그러나 영구 연결이 바람직하지 않은 경우 goOffline() 및 goOnline() 메서드를 사용하여 클라이언트 연결을 제어할 수 있습니다.

오프라인 상태에서는 클라이언트가 더 이상 데이터베이스에서 데이터 업데이트를 수신하지 않습니다. 그러나 로컬에서 수행된 모든 데이터베이스 작업은 계속해서 이벤트를 즉시 발생시키므로 애플리케이션이 계속 정상적으로 작동할 수 있습니다. 또한 로컬에서 수행한 각 작업은 자동으로 대기열에 추가되고 데이터베이스 서버에 다시 연결될 때 재시도됩니다.

데이터베이스에 다시 연결하고 원격 이벤트 수신을 시작하려면 goOnline()를 참고하세요.

서명:

export declare function goOffline(db: Database): void;

매개변수

매개변수	유형	설명
db	데이터베이스	연결을 해제할 인스턴스입니다.

반환:

void

goOnline(db)

서버에 다시 연결하고 오프라인 데이터베이스 상태를 서버 상태와 동기화합니다.

이 메서드는 goOffline()를 사용한 활성 연결을 사용 중지한 후에 사용해야 합니다. 다시 연결되면 클라이언트는 적절한 데이터를 전송하고 적절한 이벤트를 실행하여 클라이언트가 '따라잡습니다'. 자동으로 확장 및 축소할 수 있습니다

서명:

export declare function goOnline(db: Database): void;

매개변수

매개변수	유형	설명
db	데이터베이스	다시 연결할 인스턴스입니다.

반환:

void

ref(db, path)

데이터베이스에서 제공된 경로에 해당하는 위치를 나타내는 Reference를 반환합니다. 경로를 입력하지 않으면 Reference가 데이터베이스의 루트를 가리킵니다.

서명:

export declare function ref(db: Database, path?: string): DatabaseReference;

매개변수

매개변수	유형	설명
db	데이터베이스	참조를 가져올 데이터베이스 인스턴스입니다.
경로	문자열	반환된 `Reference`가 가리키는 위치를 나타내는 선택적 경로입니다. 제공되지 않으면 반환된 `Reference`가 데이터베이스의 루트를 가리킵니다.

반환:

데이터베이스 참조

경로가 제공된 경우 제공된 경로를 가리키는 Reference입니다. 그 외의 경우에는 데이터베이스의 루트를 가리키는 Reference입니다.

refFromURL(db, url)

제공된 Firebase URL에 해당하는 데이터베이스의 위치를 나타내는 Reference를 반환합니다.

URL이 유효한 Firebase 데이터베이스 URL이 아니거나 현재 Database 인스턴스와 도메인이 다른 경우 예외가 발생합니다.

모든 쿼리 매개변수 (orderBy, limitToLast 등)는 무시되며 반환된 Reference에 적용되지 않습니다.

서명:

export declare function refFromURL(db: Database, url: string): DatabaseReference;

매개변수

매개변수	유형	설명
db	데이터베이스	참조를 가져올 데이터베이스 인스턴스입니다.
url	문자열	반환된 `Reference`가 가리키는 Firebase URL입니다.

반환:

데이터베이스 참조

제공된 Firebase URL을 가리키는 Reference입니다.

함수()

forceLongPolling()

Websockets 대신 longPolling을 강제로 사용합니다. databaseURL에 Websocket 프로토콜이 사용된 경우 무시됩니다.

서명:

export declare function forceLongPolling(): void;

반환:

void

forceWebSockets()

longPolling 대신 WebSocket을 강제로 사용합니다.

서명:

export declare function forceWebSockets(): void;

반환:

void

orderByKey()

키에 따라 정렬하는 새 QueryConstraint를 만듭니다.

쿼리 결과를 (오름차순) 키 값을 기준으로 정렬합니다.

orderByKey()에 관한 자세한 내용은 데이터 정렬을 참고하세요.

서명:

export declare function orderByKey(): QueryConstraint;

반환:

쿼리 제약 조건

orderByPriority()

우선순위에 따라 정렬하는 새 QueryConstraint를 만듭니다.

애플리케이션에서 우선순위를 사용할 필요는 없지만 일반 속성에 따라 컬렉션을 정렬할 수 있습니다 (우선순위의 대안은 데이터 정렬 참고).

서명:

export declare function orderByPriority(): QueryConstraint;

반환:

쿼리 제약 조건

orderByValue()를 호출하여

값에 따라 정렬하는 새 QueryConstraint를 만듭니다.

쿼리의 하위 요소가 모두 스칼라 값 (문자열, 숫자 또는 불리언)인 경우 결과를 (오름차순) 값에 따라 정렬할 수 있습니다.

orderByValue()에 관한 자세한 내용은 데이터 정렬을 참고하세요.

서명:

export declare function orderByValue(): QueryConstraint;

반환:

쿼리 제약 조건

serverTimestamp()

Firebase 서버에서 결정된 현재 타임스탬프 (Unix 에포크 이후의 시간, 밀리초)를 자동으로 입력하기 위한 자리표시자 값을 반환합니다.

서명:

export declare function serverTimestamp(): object;

반환:

객체

함수(델타, ...)

증분(델타)

제공된 델타만큼 현재 데이터베이스 값을 원자적으로 증분하는 데 사용할 수 있는 자리표시자 값을 반환합니다.

서명:

export declare function increment(delta: number): object;

매개변수

매개변수	유형	설명
델타	숫자	현재 값을 원자적으로 수정하는 양입니다.

반환:

객체

서버 측에서 데이터를 원자적으로 수정하기 위한 자리표시자 값입니다.

function(사용 설정됨, ...)

enableLogging(사용 설정됨, 영구)

콘솔에 디버깅 정보를 로깅합니다.

서명:

export declare function enableLogging(enabled: boolean, persistent?: boolean): any;

매개변수

매개변수	유형	설명
사용 설정됨	부울	`true`인 경우 로깅을 사용 설정하고 `false`인 경우 로깅을 사용 중지합니다.
영구	부울	`true`인 경우 페이지 새로고침 사이에 로깅 상태를 기억합니다.

반환:

모두

function(limit, ...)

limitToFirst(limit)

첫 번째 특정 하위 요소 수로 제한된 경우 새 QueryConstraint를 만듭니다.

limitToFirst() 메서드는 지정된 콜백에서 동기화할 하위 요소의 최대 개수를 설정하는 데 사용됩니다. 제한을 100개로 설정하면 처음에 최대 100개의 child_added 이벤트만 수신합니다. 데이터베이스에 저장된 메시지가 100개 미만이면 메시지마다 child_added 이벤트가 발생합니다. 하지만 메시지가 100개를 초과하는 경우 정렬된 처음 100개의 메시지에 대해서만 child_added 이벤트가 수신됩니다. 상품이 변경됨에 따라 활성 목록에서 삭제되는 각 상품에 대해 child_removed 이벤트를 수신하므로 총 개수는 100개로 유지됩니다.

limitToFirst()에 대한 자세한 내용은 데이터 필터링을 참조하세요.

서명:

export declare function limitToFirst(limit: number): QueryConstraint;

매개변수

매개변수	유형	설명
제한	숫자	이 쿼리에 포함할 최대 노드 수입니다.

반환:

쿼리 제약 조건

limitToLast(limit)

마지막으로 지정된 수의 하위 요소만 반환하도록 제한된 새 QueryConstraint를 만듭니다.

limitToLast() 메서드는 지정된 콜백에서 동기화할 하위 요소의 최대 개수를 설정하는 데 사용됩니다. 제한을 100개로 설정하면 처음에 최대 100개의 child_added 이벤트만 수신합니다. 데이터베이스에 저장된 메시지가 100개 미만이면 메시지마다 child_added 이벤트가 발생합니다. 하지만 메시지가 100개를 넘는 경우 정렬된 마지막 메시지 100개에 대한 child_added 이벤트만 수신됩니다. 상품이 변경됨에 따라 활성 목록에서 삭제되는 각 상품에 대해 child_removed 이벤트를 수신하므로 총 개수는 100개로 유지됩니다.

limitToLast()에 대한 자세한 내용은 데이터 필터링을 참조하세요.

서명:

export declare function limitToLast(limit: number): QueryConstraint;

매개변수

매개변수	유형	설명
제한	숫자	이 쿼리에 포함할 최대 노드 수입니다.

반환:

쿼리 제약 조건

function(로거, ...)

enableLogging(로거)

콘솔에 디버깅 정보를 로깅합니다.

서명:

export declare function enableLogging(logger: (message: string) => unknown): any;

매개변수

매개변수	유형	설명
logger	(메시지: 문자열) => 알 수 없음	항목이 로깅되는 방식을 제어하는 커스텀 로거 함수입니다.

반환:

모두

function(parent, ...)

하위(상위, 경로)

지정된 상대 경로에 있는 위치의 Reference를 가져옵니다.

상대 경로는 간단한 하위 이름 (예: 'ada')이거나 더 깊은 슬래시로 구분된 경로 (예: 'ada/name/first')일 수 있습니다.

서명:

export declare function child(parent: DatabaseReference, path: string): DatabaseReference;

매개변수

매개변수	유형	설명
parent	데이터베이스 참조	상위 위치입니다.
경로	문자열	이 위치에서 원하는 하위 위치까지의 상대 경로입니다.

반환:

데이터베이스 참조

지정된 하위 위치입니다.

push(상위, 값)

고유 키를 사용하여 새 하위 위치를 생성하고 Reference를 반환합니다.

이는 항목 컬렉션에 데이터를 추가하는 가장 일반적인 패턴입니다.

push()에 값을 제공하면 생성된 위치에 값이 작성됩니다. 값을 전달하지 않으면 데이터베이스에 아무것도 기록되지 않고 하위 요소가 비어 있게 됩니다. 하지만 다른 곳에서 Reference를 사용할 수 있습니다.

push()로 생성된 고유 키는 현재 시간을 기준으로 정렬되므로 결과 항목 목록은 시간순으로 정렬됩니다. 또한 키는 추측할 수 없도록 설계되었습니다 (72개의 임의 비트 엔트로피가 포함됨).

데이터 목록에 추가를 참조하세요. 고유 식별자를 보장하는 2^120 방법을 참조하세요.

서명:

export declare function push(parent: DatabaseReference, value?: unknown): ThenableReference;

매개변수

매개변수	유형	설명
parent	데이터베이스 참조	상위 위치입니다.
값	알 수 없음	생성된 위치에 쓸 선택적 값입니다.

반환:

ThenableReference

Promise 및 Reference 결합됨 쓰기가 완료되면 확인되지만 하위 위치에 Reference로 즉시 사용할 수 있습니다.

함수(경로, ...)

orderByChild(경로)

지정된 하위 키에 따라 정렬하는 새 QueryConstraint를 만듭니다.

쿼리에서 한 번에 하나의 키로만 정렬할 수 있습니다. 동일한 쿼리에서 orderByChild()를 여러 번 호출하면 오류가 발생합니다.

Firebase 쿼리를 사용하면 즉석에서 하위 키를 기준으로 데이터를 정렬할 수 있습니다. 하지만 색인을 미리 계획할 수 있다면 보안 규칙의 .indexOn 규칙을 통해 색인을 정의하여 성능을 높일 수 있습니다. 자세한 내용은 https://firebase.google.com/docs/database/security/indexing-data 규칙을 참조하세요.

orderByChild()에 관한 자세한 내용은 데이터 정렬을 참고하세요.

서명:

export declare function orderByChild(path: string): QueryConstraint;

매개변수

매개변수	유형	설명
경로	문자열	정렬 기준의 경로입니다.

반환:

쿼리 제약 조건

function(query, ...)

get(쿼리)

이 쿼리의 최신 결과를 가져옵니다.

서명:

export declare function get(query: Query): Promise<DataSnapshot>;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.

반환:

프로미스<DataSnapshot>

값을 사용할 수 있는 경우 결과 DataSnapshot으로 확인되는 Promise입니다. 클라이언트가 값을 반환할 수 없으면 (예: 서버에 연결할 수 없고 캐시된 항목이 없는 경우) 거부됩니다.

off(쿼리, eventType, 콜백)

이전에 상응하는 on*() (onValue, onChildAdded) 리스너와 연결된 콜백을 분리합니다. 참고: 이 방법은 리스너를 삭제하는 데 권장되는 방법이 아닙니다. 대신 각 on* 콜백에서 반환된 콜백 함수를 사용하세요.

이전에 on*()로 연결된 콜백을 분리합니다. 상위 리스너에 off()를 호출해도 하위 노드에 등록된 리스너가 자동으로 삭제되지 않습니다. 하위 리스너에도 off()를 호출하여 콜백을 삭제해야 합니다.

콜백을 지정하지 않으면 지정된 eventType의 모든 콜백이 삭제됩니다. 마찬가지로 eventType을 지정하지 않으면 Reference의 모든 콜백이 삭제됩니다.

수신 거부 콜백을 호출하여 개별 리스너도 삭제할 수 있습니다.

서명:

export declare function off(query: Query, eventType?: EventType, callback?: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown): void;

매개변수

매개변수	유형	설명
쿼리	쿼리	리스너가 등록된 쿼리입니다.
eventType	EventType	'value', 'child_added', 'child_changes', 'child_deleted', 'child_moved' 문자열 중 하나입니다. 생략하면 `Reference`의 모든 콜백이 삭제됩니다.
콜백	(스냅샷: DataSnapshot, previousChildName?: string \| null) => 알 수 없음	모든 콜백을 삭제하기 위해 `on()` 또는 `undefined`에 전달된 콜백 함수입니다.

반환:

void

onChildAdditional(쿼리, 콜백, cancelCallback)

특정 위치의 데이터 변경사항을 수신 대기합니다.

이는 데이터베이스에서 데이터를 읽는 기본적인 방법입니다. 콜백은 초기 데이터에 대해 트리거된 후 데이터가 변경될 때마다 다시 트리거됩니다. 업데이트 수신을 중지하려면 반환된 구독 취소 콜백을 호출합니다. 자세한 내용은 웹에서 데이터 검색을 참조하세요.

onChildAdded 이벤트는 이 위치의 초기 하위 요소마다 한 번씩 트리거되며 새 하위 요소가 추가될 때마다 다시 트리거됩니다. 콜백에 전달된 DataSnapshot는 관련 하위 요소의 데이터를 반영합니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되고 첫 번째 하위 요소인 경우 null가 전달됩니다.

서명:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName?: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName?: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChild추가(쿼리, 콜백, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChild추가(쿼리, 콜백, 취소콜, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildAdded(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildChanged(쿼리, 콜백, cancelCallback)

특정 위치의 데이터 변경사항을 수신 대기합니다.

onChildChanged 이벤트는 하위 요소 (또는 그 하위 요소)에 저장된 데이터가 변경되면 트리거됩니다. 단일 child_changed 이벤트는 하위 요소의 여러 변경사항을 나타낼 수 있습니다. 콜백에 전달되는 DataSnapshot에는 새 하위 콘텐츠가 포함됩니다. 정렬을 위해 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수 또는 첫 번째 하위 요소인 경우 null도 콜백에 전달됩니다.

서명:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildChanged(쿼리, 콜백, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildChanged(쿼리, 콜백, cancelCallback, options)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildChanged(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildMoved(쿼리, 콜백, cancelCallback)

특정 위치의 데이터 변경사항을 수신 대기합니다.

onChildMoved 이벤트는 동위 요소를 기준으로 한 위치가 변경되도록 하위 요소의 정렬 순서가 변경될 때 트리거됩니다. 콜백에 전달되는 DataSnapshot는 이동한 하위 요소의 데이터에 사용됩니다. 또한 정렬 순서에 따라 이전 동위 하위 요소의 키를 포함하는 문자열인 두 번째 인수가 전달되거나 첫 번째 하위 요소인 경우 null가 전달됩니다.

서명:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildMoved(쿼리, 콜백, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildMove(쿼리, 콜백, cancelCallback, options)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onChildMoved(query: Query, callback: (snapshot: DataSnapshot, previousChildName: string | null) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot, previousChildName: string \| null) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildRemoved(쿼리, 콜백, cancelCallback)

특정 위치의 데이터 변경사항을 수신 대기합니다.

onChildRemoved 이벤트는 하위 요소가 삭제될 때마다 한 번 트리거됩니다. 콜백에 전달되는 DataSnapshot는 삭제된 하위 요소의 이전 데이터입니다. 다음의 경우 자녀가 삭제됩니다.

클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 명시적으로 remove()를 호출합니다. 클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 set(null)를 호출합니다. 하위 요소가 모든 하위 요소를 삭제했습니다. 이제 하위 항목을 필터링하는 쿼리가 있습니다 (정렬 순서가 변경되었거나 최대 한도에 도달했으므로).

서명:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildRemoved(쿼리, 콜백, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 명시적으로 remove()를 호출합니다. 클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 set(null)를 호출합니다. 하위 요소가 모든 하위 요소를 삭제했습니다. 이제 하위 항목을 필터링하는 쿼리가 있습니다 (정렬 순서가 변경되었거나 최대 한도에 도달했으므로).

서명:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onChildRemoved(쿼리, 콜백, cancelCallback, options)

특정 위치의 데이터 변경사항을 수신 대기합니다.

클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 명시적으로 remove()를 호출합니다. 클라이언트가 해당 하위 요소 또는 상위 항목 중 하나에서 set(null)를 호출합니다. 하위 요소가 모든 하위 요소를 삭제했습니다. 이제 하위 항목을 필터링하는 쿼리가 있습니다 (정렬 순서가 변경되었거나 최대 한도에 도달했으므로).

서명:

export declare function onChildRemoved(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 이 콜백에는 정렬 순서에 따라 이전 하위 요소의 키를 포함하는 문자열과 DataSnapshot이 전달되거나 첫 번째 하위 요소인 경우 `null`이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onValue(쿼리, 콜백, cancelCallback)

특정 위치의 데이터 변경사항을 수신 대기합니다.

onValue 이벤트는 이 위치에 저장된 초기 데이터로 한 번 트리거된 다음 데이터가 변경될 때마다 다시 트리거됩니다. 콜백에 전달되는 DataSnapshot는 on()가 호출된 위치에 관한 것입니다. 전체 콘텐츠가 동기화될 때까지 트리거되지 않습니다. 위치에 데이터가 없으면 빈 DataSnapshot로 트리거됩니다 (val()은 null를 반환함).

서명:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback?: (error: Error) => unknown): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 콜백에 DataSnapshot이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onValue(쿼리, 콜백, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 콜백에 DataSnapshot이 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

onValue(쿼리, 콜백, cancelCallback, 옵션)

특정 위치의 데이터 변경사항을 수신 대기합니다.

서명:

export declare function onValue(query: Query, callback: (snapshot: DataSnapshot) => unknown, cancelCallback: (error: Error) => unknown, options: ListenOptions): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리	실행할 쿼리입니다.
콜백	(스냅샷: DataSnapshot) => 알 수 없음	지정된 이벤트가 발생할 때 실행되는 콜백입니다. 콜백에 DataSnapshot이 전달됩니다.
취소 콜백	(오류: 오류) => 알 수 없음	클라이언트가 이 데이터를 읽을 권한이 없거나 권한을 가지고 있었지만 지금은 손실되어 이벤트 구독이 취소된 경우 알림을 받는 콜백 (선택사항)입니다. 이 콜백에는 실패 이유를 나타내는 `Error` 객체가 전달됩니다.
옵션	ListenOptions	`onlyOnce`을 구성하는 데 사용할 수 있는 객체로, 첫 번째 호출 후 리스너를 삭제합니다.

반환:

수신 거부

리스너를 삭제하기 위해 호출할 수 있는 함수입니다.

query(query, queryConstraints)

추가 쿼리 제약 조건도 포함하도록 확장되는 변경 불가능한 Query 인스턴스를 새로 만듭니다.

서명:

export declare function query(query: Query, ...queryConstraints: QueryConstraint[]): Query;

매개변수

매개변수	유형	설명
쿼리	쿼리	새 제약조건의 기반으로 사용할 쿼리 인스턴스입니다.
queryConstraints	쿼리 제약 조건[]	적용할 `QueryConstraint` 목록입니다.

반환:

쿼리

예외

제공된 쿼리 제약조건 중 하나라도 기존 제약조건 또는 새 제약조건과 결합할 수 없는 경우

함수(ref, ...)

onDisconnect(참조)

OnDisconnect 객체를 반환합니다. 사용 방법에 관한 자세한 내용은 JavaScript에서 오프라인 기능 사용 설정을 참고하세요.

서명:

export declare function onDisconnect(ref: DatabaseReference): OnDisconnect;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	OnDisconnect 트리거를 추가할 참조입니다.

반환:

연결 해제

삭제(참조)

이 데이터베이스 위치에서 데이터를 삭제합니다.

하위 위치의 데이터도 모두 삭제됩니다.

삭제 효과와 해당 이벤트 '값'이 즉시 표시됩니다. 트리거됩니다 제거를 Firebase 서버로 동기화하는 작업도 시작되고, 반환된 프로미스는 완료되면 해결됩니다. 제공되는 경우 동기화가 완료된 후 onComplete 콜백이 비동기식으로 호출됩니다.

서명:

export declare function remove(ref: DatabaseReference): Promise<void>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	삭제할 위치입니다.

반환:

프로미스<void>

서버에서 삭제가 완료되면 해결합니다.

runTransaction(ref, 트랜잭션 업데이트, 옵션)

이 위치의 데이터를 원자적으로 수정합니다.

이 위치의 데이터를 원자적으로 수정합니다. 이전 값과 관계없이 데이터를 덮어쓰는 일반 set()와 달리 runTransaction()는 기존 값을 새 값으로 수정하는 데 사용되므로 같은 위치에 동시에 쓰는 다른 클라이언트와 충돌하지 않습니다.

이를 위해 현재 값을 새 값으로 변환하는 데 사용되는 업데이트 함수를 runTransaction()에 전달합니다. 새 값이 기록되기 전에 다른 클라이언트가 해당 위치에 쓰기 작업을 수행하면 업데이트 함수가 새로운 현재 값으로 다시 호출되고 쓰기가 다시 시도됩니다. 이 작업은 충돌 없이 쓰기가 성공하거나 업데이트 함수에서 값을 반환하지 않아 트랜잭션을 취소할 때까지 반복적으로 발생합니다.

서명:

export declare function runTransaction(ref: DatabaseReference, transactionUpdate: (currentData: any) => unknown, options?: TransactionOptions): Promise<TransactionResult>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	원자적으로 수정할 위치입니다.
트랜잭션 업데이트	(currentData: 모두) => 알 수 없음	개발자가 제공하는 함수로, 이 위치에 저장된 현재 데이터를 (JavaScript 객체로) 전달합니다. 이 함수는 쓰려는 새 값을 JavaScript 객체로 반환해야 합니다. `undefined`가 반환되면 (즉, 인수 없이 반환하면) 트랜잭션이 중단되고 이 위치의 데이터가 수정되지 않습니다.
옵션	TransactionOptions	트랜잭션을 구성하는 옵션 객체입니다.

반환:

프로미스<TransactionResult>

onComplete 콜백 대신 선택적으로 사용하여 성공 및 실패를 처리할 수 있는 Promise

set(ref, value)

이 데이터베이스 위치에 데이터를 씁니다.

이 위치와 모든 하위 위치의 데이터를 덮어씁니다.

쓰기 효과가 즉시 표시되고 해당 이벤트('value', 'child_added' 등)가 트리거됩니다. Firebase 서버와의 데이터 동기화도 시작되고 완료되면 반환된 프로미스가 해결됩니다. 제공되는 경우 onComplete 콜백은 동기화가 완료된 후 비동기식으로 호출됩니다.

새 값에 null을 전달하는 것은 remove()를 호출하는 것과 같습니다. 즉, 이 위치의 모든 데이터와 모든 하위 위치가 삭제됩니다.

set()는 이 위치에 저장된 우선순위를 삭제하므로 우선순위를 유지하려면 setWithPriority()를 대신 사용해야 합니다.

set()로 데이터를 수정하면 해당 위치에서 대기 중인 거래가 취소되므로 set()와 transaction()를 혼합하여 동일한 데이터를 수정하는 경우 각별히 주의해야 합니다.

단일 set()는 단일 '값'을 생성합니다. set()가 수행된 위치에서 이벤트가 발생합니다.

서명:

export declare function set(ref: DatabaseReference, value: unknown): Promise<void>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	쓸 위치입니다.
값	알 수 없음	써야 하는 값입니다 (문자열, 숫자, 부울, 객체, 배열 또는 null).

반환:

프로미스<void>

서버에 쓰기가 완료되면 해결합니다.

setPriority(ref, 우선순위)

이 데이터베이스 위치에 있는 데이터의 우선순위를 설정합니다.

애플리케이션은 우선순위를 사용할 필요가 없지만 일반 속성에 따라 컬렉션을 정렬할 수 있습니다 (데이터 정렬 및 필터링 참조).

서명:

export declare function setPriority(ref: DatabaseReference, priority: string | number | null): Promise<void>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	쓸 위치입니다.
priority	문자열 \| 숫자 \| 없음	쓰려는 우선순위 (문자열, 숫자 또는 null)입니다.

반환:

프로미스<void>

서버에 쓰기가 완료되면 해결합니다.

setWithPriority(ref, value, 우선순위)

데이터베이스 위치에 데이터를 씁니다. set()와 같지만 해당 데이터의 우선순위도 지정합니다.

애플리케이션은 우선순위를 사용할 필요가 없지만 일반 속성에 따라 컬렉션을 정렬할 수 있습니다 (데이터 정렬 및 필터링 참조).

서명:

export declare function setWithPriority(ref: DatabaseReference, value: unknown, priority: string | number | null): Promise<void>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	쓸 위치입니다.
값	알 수 없음	써야 하는 값입니다 (문자열, 숫자, 부울, 객체, 배열 또는 null).
priority	문자열 \| 숫자 \| 없음	쓰려는 우선순위 (문자열, 숫자 또는 null)입니다.

반환:

프로미스<void>

서버에 쓰기가 완료되면 해결합니다.

update(ref, values)

한 번에 여러 값을 데이터베이스에 씁니다.

values 인수에는 데이터베이스에 함께 작성될 여러 속성-값 쌍이 포함됩니다. 각 하위 속성은 간단한 속성 (예: 'name') 또는 현재 위치에서 업데이트할 데이터까지의 상대 경로 (예: 'name/first')일 수 있습니다.

set() 메서드와 달리 update()는 현재 위치에서 참조된 속성만 선택적으로 업데이트하는 데 사용할 수 있습니다 (현재 위치에서 모든 하위 속성을 대체하는 대신).

단일 update()는 단일 '값'을 생성합니다. 수정된 하위 요소 수와 관계없이 update()가 실행된 위치에서 이벤트가 발생합니다.

update()로 데이터를 수정하면 해당 위치에서 대기 중인 거래가 취소되므로 update()와 transaction()를 혼합하여 동일한 데이터를 수정하는 경우 각별히 주의해야 합니다.

null를 update()에 전달하면 이 위치의 데이터가 삭제됩니다.

여러 위치 업데이트 등의 소개를 참고하세요.

서명:

export declare function update(ref: DatabaseReference, values: object): Promise<void>;

매개변수

매개변수	유형	설명
ref	데이터베이스 참조	쓸 위치입니다.
값	객체	여러 값을 포함하는 객체입니다.

반환:

프로미스<void>

서버에서 업데이트가 완료되면 해결합니다.

함수(값, ...)

endAt(값, 키)

지정된 종료 지점이 있는 QueryConstraint를 만듭니다.

startAt(), startAfter(), endBefore(), endAt(), equalTo()를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.

종료 지점이 포함되므로 지정된 값을 정확하게 가진 하위 항목이 쿼리에 포함됩니다. 선택적 키 인수는 쿼리 범위를 추가로 제한하는 데 사용할 수 있습니다. 이 속성을 지정하면 지정된 값이 정확하게 지정된 하위 항목의 키 이름도 지정된 키보다 작거나 같아야 합니다.

endAt()에 대한 자세한 내용은 데이터 필터링을 참조하세요.

서명:

export declare function endAt(value: number | string | boolean | null, key?: string): QueryConstraint;

매개변수

매개변수	유형	설명
값	숫자 \| 문자열 \| 부울 \| 없음	종료시킬 값입니다. 인수 유형은 이 쿼리에서 사용된 `orderBy()` 함수에 따라 다릅니다. `orderBy``()` 유형과 일치하는 값을 지정합니다. `orderByKey()`와 함께 사용하는 경우 값은 문자열이어야 합니다.
키	문자열	이전에 지정한 우선순위를 가진 하위 요소 중에서 종료할 하위 키입니다. 이 인수는 하위, 값 또는 우선순위에 따라 정렬하는 경우에만 허용됩니다.

반환:

쿼리 제약 조건

endBefore(값, 키)

지정된 종료 지점 (제외)이 있는 QueryConstraint를 만듭니다.

startAt(), startAfter(), endBefore(), endAt(), equalTo()를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.

종료점은 배타적입니다. 값만 제공되는 경우 지정된 값보다 작은 값을 가진 하위 항목이 쿼리에 포함됩니다. 키가 지정된 경우 하위 요소의 값은 지정된 값보다 작거나 같아야 하고 키 이름은 지정된 키보다 작아야 합니다.

서명:

export declare function endBefore(value: number | string | boolean | null, key?: string): QueryConstraint;

매개변수

매개변수	유형	설명
값	숫자 \| 문자열 \| 부울 \| 없음	전에 종료할 값입니다. 인수 유형은 이 쿼리에서 사용된 `orderBy()` 함수에 따라 다릅니다. `orderBy``()` 유형과 일치하는 값을 지정합니다. `orderByKey()`와 함께 사용하는 경우 값은 문자열이어야 합니다.
키	문자열	이전에 지정된 우선순위를 가진 하위 요소 중에서 이전에 종료할 하위 키입니다. 이 인수는 하위, 값 또는 우선순위에 따라 정렬하는 경우에만 허용됩니다.

반환:

쿼리 제약 조건

같음(값, 키)

지정된 값과 일치하는 하위 요소가 포함된 QueryConstraint를 만듭니다.

startAt(), startAfter(), endBefore(), endAt(), equalTo()를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.

선택적 키 인수는 쿼리 범위를 추가로 제한하는 데 사용할 수 있습니다. 이 속성이 지정된 경우 정확하게 지정된 값을 가진 하위 요소도 정확히 지정된 키를 키 이름으로 가져야 합니다. 이는 동일한 값에 대해 일치하는 항목이 많은 결과 집합을 필터링하는 데 사용할 수 있습니다.

equalTo()에 대한 자세한 내용은 데이터 필터링을 참조하세요.

서명:

export declare function equalTo(value: number | string | boolean | null, key?: string): QueryConstraint;

매개변수

매개변수	유형	설명
값	숫자 \| 문자열 \| 부울 \| 없음	일치시킬 값입니다. 인수 유형은 이 쿼리에서 사용된 `orderBy()` 함수에 따라 다릅니다. `orderBy``()` 유형과 일치하는 값을 지정합니다. `orderByKey()`와 함께 사용하는 경우 값은 문자열이어야 합니다.
키	문자열	이전에 지정된 우선순위를 가진 하위 요소 중에서 시작할 하위 키입니다. 이 인수는 하위, 값 또는 우선순위에 따라 정렬하는 경우에만 허용됩니다.

반환:

쿼리 제약 조건

startAfter(값, 키)

지정된 시작점 (제외)이 있는 QueryConstraint를 만듭니다.

startAt(), startAfter(), endBefore(), endAt(), equalTo()를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.

시작점은 배타적입니다. 값만 제공되는 경우 지정된 값보다 큰 값을 가진 하위 항목이 쿼리에 포함됩니다. 키가 지정된 경우 하위 요소는 지정된 값보다 크거나 같은 값과 지정된 키보다 큰 키 이름을 가져야 합니다.

서명:

export declare function startAfter(value: number | string | boolean | null, key?: string): QueryConstraint;

매개변수

매개변수	유형	설명
값	숫자 \| 문자열 \| 부울 \| 없음	이후에 시작할 값입니다. 인수 유형은 이 쿼리에서 사용된 `orderBy()` 함수에 따라 다릅니다. `orderBy``()` 유형과 일치하는 값을 지정합니다. `orderByKey()`와 함께 사용하는 경우 값은 문자열이어야 합니다.
키	문자열	시작할 하위 키입니다. 이 인수는 하위, 값 또는 우선순위에 따라 정렬하는 경우에만 허용됩니다.

반환:

쿼리 제약 조건

startAt(값, 키)

지정된 시작점으로 QueryConstraint를 만듭니다.

startAt(), startAfter(), endBefore(), endAt(), equalTo()를 사용하면 쿼리의 시작 및 종료 지점을 임의로 선택할 수 있습니다.

시작점에 포함되므로 정확히 지정된 값을 가진 하위 요소가 쿼리에 포함됩니다. 선택적 키 인수는 쿼리 범위를 추가로 제한하는 데 사용할 수 있습니다. 이 속성을 지정하면 지정된 값이 정확하게 지정된 하위 항목의 키 이름도 지정된 키보다 크거나 같아야 합니다.

startAt()에 대한 자세한 내용은 데이터 필터링을 참조하세요.

서명:

export declare function startAt(value?: number | string | boolean | null, key?: string): QueryConstraint;

매개변수

매개변수	유형	설명
값	숫자 \| 문자열 \| 부울 \| 없음	시작하는 값입니다. 인수 유형은 이 쿼리에서 사용된 `orderBy()` 함수에 따라 다릅니다. `orderBy``()` 유형과 일치하는 값을 지정합니다. `orderByKey()`와 함께 사용하는 경우 값은 문자열이어야 합니다.
키	문자열	시작할 하위 키입니다. 이 인수는 하위, 값 또는 우선순위에 따라 정렬하는 경우에만 허용됩니다.

반환:

쿼리 제약 조건

EventType

'value', 'child_added', 'child_changes', 'child_deleted', 'child_moved' 문자열 중 하나입니다.

서명:

export declare type EventType = 'value' | 'child_added' | 'child_changed' | 'child_moved' | 'child_removed';

쿼리 제약조건 유형

이 SDK에서 사용할 수 있는 다양한 쿼리 제약조건을 설명합니다.

서명:

export declare type QueryConstraintType = 'endAt' | 'endBefore' | 'startAt' | 'startAfter' | 'limitToFirst' | 'limitToLast' | 'orderByChild' | 'orderByKey' | 'orderByPriority' | 'orderByValue' | 'equalTo';

구독 취소

리스너를 제거하기 위해 호출할 수 있는 콜백입니다.

서명:

export declare type Unsubscribe = () => void;