javascript-tutorial / ja.javascript.info Goto Github PK

現在、更新日は「2日 一月 2021」のようなフォーマットなっています。

このフォーマットは、以下の理由で読みづらいものです。

• アラビア数字と漢数字が混在している
• 順序が日月年になっている（年月日になっていない）¹

したがって、以下のいずれかのフォーマットにするのがいいかと思います。

1. 2021-01-02（yyy-MM-dd）
   • ISO 8601の拡張形式
2. 2021/1/2（yyyy/M/d）
   • JSのDate.toLocaleDateString('ja-JP')のフォーマット
3. 2021年1月2日（yyyy年M月d日）
   • GitHub、MDN Web Docs、TypeScriptの公式ドキュメントなどで用いられているフォーマット

私の意見では、人間が読むドキュメントに記載する日付の表記としては 3 がいいのではないかと思います。

これは、私にとってそうというだけの可能性もありますが、多くの日本人にとってもあてはまるであろうと思われます。

Noticed that some tips are left untranslated. They are placed in the engine repo:

• https://github.com/javascript-tutorial/engine/blob/master/markit/locales/recent/ja.yml
• https://github.com/javascript-tutorial/engine/blob/master/markit/locales/old/ja.yml
• https://github.com/javascript-tutorial/engine/blob/master/markit/locales/error/ja.yml

Hi,

I renamed some stuff in 1-js/5-network and 1-js/11-async.

As a side effect, when you pull from upstream (from English version), git doesn't always recognize the renaming, and creates both English and Japanese versions, e.g.

1-js/11-async/05-async-await - old name (Japanese)
1-js/11-async/08-async-await - new name (English)
Please, remove 1-js/11-async/08-async-await. Instead, rename 1-js/11-async/05-async-await to 1-js/11-async/08-async-await, and adapt latest English changes to it.

P.S. Similar thing may happen with url chapter in networking when you next time pull upstream.

We updated /ebook design, please translate some new phrases in modules/ebook/locales/ja.yml.

Please translate the following titles:

Part I. The JavaScript Language
340+ pages, PDF + EPUB

Part II. Browser: Document, Events, Interfaces
220+ pages, PDF + EPUB

Part III. Additional Articles (Animations, Async/Await, etc.)
150+ pages, PDF + EPUB

Parts I && II together
2xPDF + 2xEPUB, (560+ pages)

Full Tutorial (all 3 parts)
3xEPUB + 3xPDF, (710+ pages)

P.S. Please leave the pages count (like 710+) "as is", not translated, if possible.

Body Body

Maintainer

@KenjiI

For New Translators

To translate a page:

1. Check that no one else has claimed your page in the checklist and comments below.
2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find find that you can't commit any more, let the maintainers know so they can assign the page to someone else.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

• Home Page (@lex111) #1

When PRs are merged, make sure to mark that page as completed!

The JavaScript language

An introduction

• An Introduction to JavaScript
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables
• Data types
• Type Conversions
• Operators
• Comparisons
• Interaction: alert, prompt, confirm
• Conditional operators: if, '?'
• Logical operators
• Loops: while and for
• The "switch" statement
• Functions
• Function expressions and arrows
• JavaScript specials

Code quality

• Debugging in Chrome
• Coding Style
• Comments
• Ninja code
• Automated testing with mocha
• Polyfills

Objects: the basics

• Objects
• Garbage collection
• Symbol type
• Object methods, "this"
• Object to primitive conversion
• Constructor, operator "new"

Data types

• Methods of primitives
• Numbers
• Strings
• Arrays
• Array methods
• Iterables
• Map, Set, WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread operator
• Closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Currying and partials
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto
• Getting all properties

Classes

• Class patterns
• Classes
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending build-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try..catch"
• Custom errors, extending Error

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Promise API
• Promisification
• Microtasks and event loop
• Async/await

Generators, advanced iteration

• Generators
• Async iteration and generators

Modules

• Modules, introduction
• Export and Import
• Dynamic imports

Browser: Document, Events, Interfaces

Document

• Browser environment, specs
• DOM tree
• Walking the DOM
• Searching: getElement* and querySelector*
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction into Events

• Introduction to browser events
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events basics
• Moving: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Keyboard: keydown and keyup
• Scrolling

Forms, controls

• Form properties and methods
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Form submission: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch: Basics
• Fetch: Download progress
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• WebSocket

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height
• Custom elements
• Shadow DOM
• Template element
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags
• Methods of RegExp and String
• Character classes
• Escaping, special characters
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \n and \k
• Alternation (OR) |
• String start ^ and finish $
• Multiline mode, flag "m"
• Lookahead and lookbehind
• Infinite backtracking problem
• Unicode: flag "u"
• Unicode character properies \p
• Sticky flag "y", searching at position

Miscellaneous

• Mutation observer

binary + は 二項 +(演算子) の方が適切かなと思います。

単項 + と対となるように 二項 + としたほうがわかりやすいと思います。

- 用語： “単項演算子”、 “バイナリ”、 “オペランド”
+ 用語： “単項演算子”、 “二項演算子”、 “オペランド”

• https://ja.javascript.info/operators
• https://javascript.info/operators
• https://ja.wikipedia.org/wiki/%E6%BC%94%E7%AE%97%E5%AD%90#%E4%BA%8C%E9%A0%85%E6%BC%94%E7%AE%97%E5%AD%90

演算子が2つのオペランドを持つ場合は バイナリ です。同じマイナスもバイナリ形式で同様に存在します:

この辺を見ていて、2進数的なバイナリの話に見えてしまうと思うので。

In about section of repository change website from javascript.info to ja.javascript.info

日本語版のボタンを取得する: whichで

event.which == 1 – 左ボタン

という説明があるが、英語版のMouse buttonでは

As of now, event.which is deprecated, we shouldn’t use it.

という説明があり、event.buttonの使用を推奨する説明になっていると思います。

Maintainer List

@KenjiI

For New Translators

For Maintainers

Only maintainers can check/uncheck items below. If you're not, please write in a comment what you take to translate.

The JavaScript language

An introduction

• An Introduction to JavaScript
• Manuals and specifications
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables
• Data types
• Type Conversions
• Operators
• Comparisons
• Interaction: alert, prompt, confirm
• Conditional operators: if, '?'
• Logical operators
• Loops: while and for
• The "switch" statement
• Functions
• Function expressions and arrows
• JavaScript specials

Code quality

• Debugging in Chrome
• Coding Style
• Comments
• Ninja code
• Automated testing with mocha
• Polyfills

Objects: the basics

• Objects
• Garbage collection
• Symbol type
• Object methods, "this"
• Object to primitive conversion
• Constructor, operator "new"

Data types

• Methods of primitives
• Numbers
• Strings
• Arrays
• Array methods
• Iterables
• Map, Set, WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread operator
• Closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Currying and partials
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto

Classes

• Class basic syntax
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending built-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try..catch"
• Custom errors, extending Error

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Promise API
• Promisification
• Microtasks
• Async/await

Generators, advanced iteration

• Generators
• Async iterators and generators

Modules

• Modules, introduction
• Export and Import
• Dynamic imports

Miscellaneous

• Proxy and Reflect
• Eval: run a code string

Browser: Document, Events, Interfaces

Document

• Browser environment, specs
• DOM tree
• Walking the DOM
• Searching: getElement*, querySelector*
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events basics
• Moving: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Keyboard: keydown and keyup
• Scrolling

Forms, controls

• Form properties and methods
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Forms: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer (@KenjiI )
• Selection and Range (@KenjiI )
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch
• FormData
• Fetch: Download progress (@KenjiI )
• Fetch: Abort (@KenjiI )
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height
• Custom elements
• Shadow DOM
• Template element
• Shadow DOM slots, composition (@KenjiI )
• Shadow DOM styling (@morita657)
• Shadow DOM and events (@morita657 )

Regular expressions

• Patterns and flags
• Methods of RegExp and String
• Character classes
• Escaping, special characters
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \n and \k
• Alternation (OR) |
• String start ^ and finish $
• Multiline mode, flag "m"
• Lookahead and lookbehind
• Infinite backtracking problem
• Unicode: flag "u"
• Unicode character properties \p
• Sticky flag "y", searching at position

内容

asyncであると思われる箇所がasynになっておりましたので報告させていただきます。
https://github.com/javascript-tutorial/ja.javascript.info/blob/master/2-ui/5-loading/02-script-async-defer/article.md?plain=1#L126

ページ

https://ja.javascript.info/script-async-defer#ref-720

Some article's are translated some time ago, so it is necessary to compare to the English one and take in differences between them.
This issue is to update each articles to latest one in English ver (from 2021/01/01 〜).

Maintainer List

@KenjiI

For New Translators

For Maintainers

Only maintainers can check/uncheck items below. If you're not, please write in a comment what you take to translate.

The JavaScript language

An introduction

• An Introduction to JavaScript
• Manuals and specifications
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables
• Data types
• Type Conversions
• Operators
• Comparisons
• Interaction: alert, prompt, confirm
• Conditional operators: if, '?'
• Logical operators
• Loops: while and for
• The "switch" statement
• Functions
• Function expressions and arrows
• JavaScript specials

Code quality

• Debugging in Chrome
• Coding Style
• Comments
• Ninja code
• Automated testing with mocha
• Polyfills

Objects: the basics

• Objects
• Garbage collection
• Symbol type
• Object methods, "this"
• Object to primitive conversion
• Constructor, operator "new"

Data types

• Methods of primitives
• Numbers
• Strings
• Arrays
• Array methods
• Iterables
• Map, Set, WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread operator
• Closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Currying and partials (@toku-sa-n )
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto

Classes

• Class basic syntax
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending built-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try..catch"
• Custom errors, extending Error

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Promise API
• Promisification
• Microtasks
• Async/await

Generators, advanced iteration

• Generators
• Async iterators and generators

Modules

• Modules, introduction
• Export and Import
• Dynamic imports

Miscellaneous

• Proxy and Reflect
• Eval: run a code string

Browser: Document, Events, Interfaces

Document

• Browser environment, specs
• DOM tree
• Walking the DOM
• Searching: getElement*, querySelector*
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events basics
• Moving: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Keyboard: keydown and keyup
• Scrolling

Forms, controls

• Form properties and methods
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Forms: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer (@KenjiI )
• Selection and Range (@KenjiI )
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch
• FormData
• Fetch: Download progress
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height
• Custom elements
• Shadow DOM
• Template element
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags
• Methods of RegExp and String
• Character classes
• Escaping, special characters
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \n and \k
• Alternation (OR) |
• String start ^ and finish $
• Multiline mode, flag "m"
• Lookahead and lookbehind
• Infinite backtracking problem
• Unicode: flag "u"
• Unicode character properties \p
• Sticky flag "y", searching at position