- Building Web and Mobile ArcGIS Server Applications with JavaScript(Second Edition)
- Eric Pimpler Mark Lewin
- 289字
- 2021-07-02 15:48:54
Commenting code
It is best practice to always document your JavaScript code through the use of comments. At a minimum, this should include the author of the code, date of last revision, and the general purpose of the code. In addition, at various points throughout your code you should include comment sections that define the purpose of specific sections of the application. The purpose of this documentation is to make it easier for you or another programmer to quickly get up to speed in the event that the code needs to be updated in some way.
Any comments that you include in your code are not executed. They are simply ignored by the JavaScript interpreter. JavaScript can be commented in a couple of ways including single line and multi-line comments. Single line comments start with // and any additional characters you add to the line. The following code example shows how single line comments are created:
//this is a single line comment. This line will not be executed
Multi-line comments in JavaScript start with /* and end with */. Any lines in between are treated as comments and are not executed. The following code example shows an example of multi-line comments (also called block comments):
/* Copyright 2012 Google Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */
- Implementing VMware Horizon 7(Second Edition)
- 一步一步學Spring Boot 2:微服務項目實戰
- 零基礎搭建量化投資系統:以Python為工具
- Mastering JavaScript Object-Oriented Programming
- Java異步編程實戰
- Building a Game with Unity and Blender
- 精通搜索分析
- Java:High-Performance Apps with Java 9
- C專家編程
- Flask Web開發:基于Python的Web應用開發實戰(第2版)
- Java程序設計教程
- Robot Framework Test Automation
- Swift 2 Design Patterns
- Apache Kafka 1.0 Cookbook
- JavaScript編程精解(原書第3版)