mirror of
https://github.com/freeCodeCamp/freeCodeCamp.git
synced 2025-12-31 06:01:50 -05:00
64 lines
1.9 KiB
Markdown
64 lines
1.9 KiB
Markdown
---
|
|
id: bd7123c9c441eddfaeb4bdef
|
|
title: التعليق (Comment) في كودك من JavaScript
|
|
challengeType: 1
|
|
removeComments: false
|
|
videoUrl: 'https://scrimba.com/c/c7ynnTp'
|
|
forumTopicId: 16783
|
|
dashedName: comment-your-javascript-code
|
|
---
|
|
|
|
# --description--
|
|
|
|
إن التعليقات أسطر من الكود التي سيتجاهلها JavaScript عمداً. إن التعليقات طريقة رائعة لترك الملاحظات لنفسك وللأشخاص الآخرين الذين سيحتاجون لاحقاً إلى معرفة ما يفعله ذلك الكود.
|
|
|
|
هناك طريقتان لكتابة التعليقات في JavaScript:
|
|
|
|
استخدام `//` سيخبر JavaScript بتجاهل بقية النص في السطر الحالي. وهذه طريقة كتابة تعليق من سطر واحد:
|
|
|
|
```js
|
|
// This is an in-line comment.
|
|
```
|
|
|
|
يمكنك إنشاء تعليق متعدد الأسطر يبدأ من `/*` وينتهي في `*/`. وهذا تعليق متعدد الأسطر:
|
|
|
|
```js
|
|
/* This is a
|
|
multi-line comment */
|
|
```
|
|
|
|
**ملاحظة:** عند كتابة الكود، يجب عليك إضافة تعليقات بانتظام لتوضيح وظيفة أجزاء من كودك. التعليق الجيد يمكن أن يساعد على إيصال المغزى من كودك - للآخرين *و* لنفسك في المستقبل.
|
|
|
|
# --instructions--
|
|
|
|
حاول إنشاء واحد من كل نوع من التعليقات.
|
|
|
|
# --hints--
|
|
|
|
يجب عليك إنشاء تعليق باستخدام `//` يحتوي على خمس أحرف في الأقل.
|
|
|
|
```js
|
|
assert(code.match(/(\/\/)...../g));
|
|
```
|
|
|
|
يجب عليك إنشاء تعليق باستخدام `/* */` يحتوي على خمس أحرف في الأقل.
|
|
|
|
```js
|
|
assert(code.match(/(\/\*)([^\/]{5,})(?=\*\/)/gm));
|
|
```
|
|
|
|
# --seed--
|
|
|
|
## --seed-contents--
|
|
|
|
```js
|
|
|
|
```
|
|
|
|
# --solutions--
|
|
|
|
```js
|
|
// Fake Comment
|
|
/* Another Comment */
|
|
```
|