В JavaScript, когда мы просматриваем документацию для различных методов, мы часто видим, что они обернуты в квадратные скобки ([]). Это делается для указания того, что это метод, а не просто свойство.
Ключевое отличие между свойствами и методами в JavaScript состоит в том, что свойства представляют значения, а методы - функции. То есть, свойства представляют данные, которые могут быть прочитаны или изменены, а методы выполняют действия или операции над этими данными.
Использование [] в документации подчеркивает эту разницу и указывает, что мы имеем дело с методом. Квадратные скобки также используются, чтобы отделить методы от остальной информации и сделать их более заметными.
Когда мы видим метод, представленный в квадратных скобках, мы знаем, что он должен быть вызван с помощью круглых скобок и может возвращать некоторое значение или выполнить действие, в зависимости от его назначения.
Вот пример:
array.push(element);
В этом примере push - это метод массива array. Он обновляет массив, добавляя новый элемент в его конец. Квадратные скобки ([]) вокруг названия метода подчеркивают, что он является функцией, которую мы должны вызвать, а не просто свойством, с которым мы можем работать напрямую.
В заключение, обертка методов в квадратные скобки в документации помогает нам различать между методами и другими свойствами, что упрощает понимание и использование функциональности, предоставляемой этими методами.