throwsが見当たらないがtryキーワードがついている

Question

実現したいこと

前提

https://firebase.google.com/docs/firestore/solutions/swift-codable-data-mapping?hl=ja#handling_errors
firestoreのドキュメントで理解できない記述を見つけたため質問させていただきたいです。
collectionRef.addDocument(from: newColor)の前に　try　がついていますが、これはなぜ記述しなければいけないのでしょうか。そしてどこにthrowsがあるのでしょうか。

  func addColorEntry() {
    let collectionRef = db.collection("colors")
    do {
      let newDocReference = try collectionRef.addDocument(from: newColor)
      print("ColorEntry stored with new document reference: \(newDocReference)")
    }
    catch {
      print(error)
    }
  }

こちらはfirestoreドキュメントの別のサンプルコードですが、このコードではtryをつけずにaddDocumentメソッドを呼び出していて、違いがわかりません。
do,try,catch,throwsの基本的な文法は一応理解しているつもりです。
わかりづらい文章になってしまっているかもしれませんが、ご教授いただけますと嬉しいです。よろしくお願いいたします。

// Add a new document with a generated id.
var ref: DocumentReference? = nil
ref = db.collection("cities").addDocument(data: [
    "name": "Tokyo",
    "country": "Japan"
]) { err in
    if let err = err {
        print("Error adding document: \(err)")
    } else {
        print("Document added with ID: \(ref!.documentID)")
    }
}

念の為全てのコードを記載します。

class MappingColorsViewModel: ObservableObject {
  @Published var colorEntries = [ColorEntry]()
  @Published var newColor = ColorEntry.empty
  @Published var errorMessage: String?
  
  private var db = Firestore.firestore()
  private var listenerRegistration: ListenerRegistration?
  
  public func unsubscribe() {
    if listenerRegistration != nil {
      listenerRegistration?.remove()
      listenerRegistration = nil
    }
  }
  
  func subscribe() {
    if listenerRegistration == nil {
      listenerRegistration = db.collection("colors")
        .addSnapshotListener { [weak self] (querySnapshot, error) in
          guard let documents = querySnapshot?.documents else {
            self?.errorMessage = "No documents in 'colors' collection"
            return
          }
          
          self?.colorEntries = documents.compactMap { queryDocumentSnapshot in
            let result = Result { try queryDocumentSnapshot.data(as: ColorEntry.self) }
            
            switch result {
            case .success(let colorEntry):
              if let colorEntry = colorEntry {
                // A ColorEntry value was successfully initialized from the DocumentSnapshot.
                self?.errorMessage = nil
                return colorEntry
              }
              else {
                // A nil value was successfully initialized from the DocumentSnapshot,
                // or the DocumentSnapshot was nil.
                self?.errorMessage = "Document doesn't exist."
                return nil
              }
            case .failure(let error):
              // A ColorEntry value could not be initialized from the DocumentSnapshot.
              switch error {
              case DecodingError.typeMismatch(_, let context):
                self?.errorMessage = "\(error.localizedDescription): \(context.debugDescription)"
              case DecodingError.valueNotFound(_, let context):
                self?.errorMessage = "\(error.localizedDescription): \(context.debugDescription)"
              case DecodingError.keyNotFound(_, let context):
                self?.errorMessage = "\(error.localizedDescription): \(context.debugDescription)"
              case DecodingError.dataCorrupted(let key):
                self?.errorMessage = "\(error.localizedDescription): \(key)"
              default:
                self?.errorMessage = "Error decoding document: \(error.localizedDescription)"
              }
              return nil
            }
          }
        }
    }
  }
  
  func addColorEntry() {
    let collectionRef = db.collection("colors")
    do {
      let newDocReference = try collectionRef.addDocument(from: newColor)
      print("ColorEntry stored with new document reference: \(newDocReference)")
    }
    catch {
      print(error)
    }
  }
}

試したこと

補足情報（FW/ツールのバージョンなど）

Comments

[hoshi-takanori]

addDocument(data:) と addDocument(data:completion:) の違いだと思うけど、ドキュメントに throws がないのは変ですね…。
https://firebase.google.com/docs/reference/swift/firebasefirestore/api/reference/Classes/CollectionReference

[grf__]

コメントありがとうございます。
こちらの記事にもtryが使われているコードがあったのですが、Result型と関係があるのでしょうか。
https://ja.stackoverflow.com/questions/84114/swift-firestore-result%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6

[grf__]

こちらにthrowsのついたバージョン？のメソッドが記載されてました。
asyncについて勉強していないので理解できないのですが、どういった違いがあるのかご存知でしたらお伺いさせていただきたいです。
https://firebase.google.com/docs/reference/swift/firebasefirestore/api/reference/Classes/DocumentReference

[hoshi-takanori]

async は非同期処理のことで、例えば Firebase へのアクセスはネットワークが絡むので時間がかかり、結果を関数の戻り値で返そうとすると結果が返ってくるまで待つ必要があります。
で、addDocument(data:completion:) の場合はサーバーにリクエストを送信したらすぐに関数を抜けて、結果が帰ってきた時に改めて completion という引数で指定したクロージャが実行されます。
が、この書き方は読みづらいので、async/await というものを使うと普通に関数の結果を受け取っているかのように書くことができます。(実際にはクロージャで書いたのと同等の処理になります。)
https://qiita.com/daiki_U/items/49f12b680850f797b2fb

[MasakiHori]

`addDocument(from:`と`addDocument(data:`は別のものです。

[grf__]

@hoshi-takanori様
ご返信が遅くなり申し訳ございません。
クロージャを使った非同期処理の方法しか知らなかったため大変勉強になりました。
async/awaitを勉強してみたいと思います。

[grf__]

＠MasakiHori様
ご返信が遅くなり申し訳ございません。
同一メソッドとして混同しておりました、ご回答ありがとうございました。

Answer 1

collectionRef.addDocument(from: newColor)の前に　try　がついていますが、これはなぜ記述しなければいけないのでしょうか。そしてどこにthrowsがあるのでしょうか。

こちらで使用しているaddDocumentは、第一引数がfrom:指定になっています。これは、FirebaseFireStoreが提供しているメソッドではなく、FirebaseFireStoreSwiftが提供しているメソッドで、次の場所にAPIリファレンスがあります。

https://firebase.google.com/docs/reference/swift/firebasefirestoreswift/api/reference/Extensions/CollectionReference#adddocumentfrom:encoder:completion:

上記のリファレンスには throws がついており、tryで処理しなければならないことがわかると思います。

from:指定のaddDocumentメソッドはCodableに準拠した構造体を送信に使用できるメソッドで、FirebaseFireStoreSwiftは、Codableやasync/await等のSwiftの最新機能をFirebaseFireStoreで使用できるようにするための付加ライブラリです。(これを利用するためにFirebaseFireStoreSwiftのライブラリを追加インストールしているはずです。)

こちらはfirestoreドキュメントの別のサンプルコードですが、このコードではtryをつけずにaddDocumentメソッドを呼び出していて、違いがわかりません。

こちらで使用しているaddDocumentは、第一引数がdata:指定になっています。これは、FirebaseFireStoreが提供しているメソッド(最初から提供されているメソッド)で、次の場所にAPIリファレンスがあります。

https://firebase.google.com/docs/reference/swift/firebasefirestore/api/reference/Classes/CollectionReference#adddocumentdata:completion:

こちらはthrowsがついていないので、tryで処理する必要ありません。

Comments

[grf__]

ご回答ありがとうございます。
総括されていて大変わかりやすく、勉強になりました。