> For the complete documentation index, see [llms.txt](https://ja.docs.monaca.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ja.docs.monaca.io/sampleapp/firestorewosuru.md).

# Firestoreを利用する

### 事前準備

Firebaseの初期化を`initializeApp` で行います。

下記の`firebaseConfig`の値は、Firebase 上のWeb アプリの[firebaseConfig](https://support.google.com/firebase/answer/7015592)にあります。

`getFirestore`でFirestoreの初期化と参照を取得します。

```javascript
const firebaseConfig = {
    apiKey: "******************************",
    authDomain: "test.firebaseapp.com",
    databaseURL: "https://test.firebaseio.com",
    projectId: "test",
    storageBucket: "test.appspot.com",
    messagingSenderId: "**********",
    appId: "1:**********:web:********************"
};

const firebase = initializeApp(firebaseConfig);
const db = getFirestore(firebase)
```

### ライブラリのインポート

Firebaseの JavaScript SDKのライブラリをCDN（コンテンツ配信ネットワーク）からプロジェクトに追加します。他のインポートについては、[こちら](https://firebase.google.com/docs/web/alt-setup)をご確認ください。

```javascript
import {
  getFirestore, collection, getDocs, addDoc, updateDoc, doc, deleteDoc, serverTimestamp,
} from 'https://www.gstatic.com/firebasejs/9.14.0/firebase-firestore.js';

import {
  initializeApp
} from "https://www.gstatic.com/firebasejs/9.14.0/firebase-app.js";
```

### 新規作成

ドキュメントの新規作成は、`addDoc()`メソッドを使用します。

Cloud Firestore はデータをドキュメントに保存。ドキュメントはコレクションに保存されます。 

次のコードでは、users コレクションに新しいドキュメントを作成します。

users コレクションが存在しない場合は、下記処理で新規にコレクションが作成されます。

```javascript
const docRef = await addDoc(collection(db, "users"), {
    name: "monaca"
});
```

### 読み取り

コレクションからのドキュメント読み取りは、`getDocs()`メソッドを使用します。

users コレクションの全てのドキュメントを読み取っています。

```javascript
const querySnapshot = await getDocs(collection(db, "users"));
querySnapshot.forEach((doc) => {
    console.log(`${doc.id} => ${doc.data()}`);
});
```

### 更新

ドキュメントの更新は、`updateDoc()`メソッドを使用します。

```javascript
const docRef = doc(db, "users", docRef.id);
await updateDoc(docRef, {
    born: 2020
});
```

### 削除

ドキュメントを削除するには、 `deleteDoc()`メソッドを使用します。

```javascript
const docRef = doc(getFirestore(), "users", docRef.id);
await deleteDoc(docRef);
```