Firebase Firestore API中的不一致

Firebase Firestore API中的不一致,firebase,google-cloud-firestore,Firebase,Google Cloud Firestore,有人能告诉我为什么不同语言SDK的firestore api中存在如此不必要的不一致性吗。firebase开发人员经常提到保持API跨平台一致性的重要性,因此让这种情况发生似乎很奇怪 在Python、Java、Android和Swift firestore SDK中,为了引用文档,所需函数的标题为document,但在Go、Web和Node中,它的标题为doc vs 在设计API时,我们试图在遵守平台习惯用法与跨平台保持一致之间取得平衡。所以这种命名方法实际上是一种有意的偏差。JavaScrip

有人能告诉我为什么不同语言SDK的firestore api中存在如此不必要的不一致性吗。firebase开发人员经常提到保持API跨平台一致性的重要性,因此让这种情况发生似乎很奇怪

在Python、Java、Android和Swift firestore SDK中,为了引用文档,所需函数的标题为document,但在Go、Web和Node中,它的标题为doc

vs


在设计API时,我们试图在遵守平台习惯用法与跨平台保持一致之间取得平衡。所以这种命名方法实际上是一种有意的偏差。JavaScript和Go通常都使用简短的方法名称,而例如Obj-C有长而详细的方法名称,因此同一方法在Obj-C中称为collectionWithPath:在Obj-C中。不同平台的方法之间通常应该有1-1对应关系,但实际的命名确实不同。对不起,如果它绊倒了你

我也注意到了这一点,我认为在Javascript中使用doc的原因是为了避免与HTML DOM document关键字混淆,但我不确定为什么在Go和Node中也选择doc。只是造成了一个小小的失误:感谢澄清。imho尽管这是错误的设计选择,特别是考虑到firestore触发器的云函数需要指定.document
var cityRef = db.collection('cities').doc('SF');
DocumentReference docRef = db.collection("cities").document("SF");