JS docs ve benzeri bir çok kez arr.fill(value[, start = 0[, end = this.length]])
gibi bir sözdizimi ile tanıştım ve kendimi anlamak zorunda kaldım. Fonksiyonun parametrelerini yazım demek istiyorum.
Bu büyük bir sorun değil, ancak bu sözdizimi hakkında daha fazla bilgi edinmek istiyorum.JS dokümanlarındaki sözdizimi hakkında bazı bilgileri nereden bulabilirim?
cevap
belgelerin Bu tarz this standard dayalı gibi görünen komut satırı araçları ve man
sayfalarında kullanılan stil dayanmaktadır (aşağıdaki this question arasındaki bağlantılar). Bu gösterim, bir süredir API ve kullanım dokümanları için oldukça standarttır.
Sıralama önemli olsa da, parantezler ([,start = 0 ...]
), sözdiziminin isteğe bağlı bir bölümünü belirtir. Örneğinizde, daha sonraki bir parametreyi belirtmek istiyorsanız, iç içe köşeli parantezler önceki bölümlerin gerekli olduğunu gösterir.
MDN dokümanlar için, bu işlev içinde hangi parametrelerin atıfta bulunduğunu göstermek için name = value
gösterimi ile birleştirilir.
arr.fill(value[, start = 0[, end = this.length]])
^---^
required argument
^--------------------------------^
optional arguments
Bu gösterim, argümanların sırasını, gereksinimini ve varsayılan değerlerini belirtir. Köşeli parantez argümanın gerekli olmadığı anlamına gelir. Köşeli parantez argümanın isteğe bağlı olduğu anlamına gelir. Eşittir sonra ne isteğe bağlı argüman için varsayılan değerdir.
Yani verilen bu imza, aşağıdaki seçenekler vardır:
arr.fill(value) // start = 0, end = this.length
arr.fill(value, start) // end = this.length
arr.fill(value, start, end)
Bunu nerede gördüğünüze dair bir örnek verebilir misiniz? –
Köşeli parantez = gerekli bağımsız değişken. – elclanrs
Bu biraz sahte kod, parantez içindeki argümanlar isteğe bağlıdır, ayrıca isteğe bağlı argümanlar için değerler gösterilir. Genellikle dokümanlar sözdizimini açıklayan bir "Sözleşme" bölümüne sahiptir. – Teemu