С этой целью группа технического перевода Breword перевела последнюю версию Koa и проверила ее на соответствие исходному коду, чтобы обеспечить максимальное понимание.
Нажмите здесь, чтобы просмотреть перевод BrewordКоа Китайская документация
По сравнению с другими переведенными версиями мы приняли несколько иной подход.стратегия перевода. Ниже приведены лишь несколько моментов для иллюстрации, и вы можете обсудить их в области комментариев.
Application
- app.proxy when true proxy header fields will be trusted.
Перевод для других версий: app.proxy, когда поле заголовка реального прокси будет доверенным
Перевод Бреворда: когда app.proxy имеет значение true, поля заголовка прокси будут проанализированы.
Здесь доверенный, мы не переводили дословно в «доверенный», а перефразировали в «разобранный».
- app.subdomainOffset offset of .subdomains to ignore [2]
Перевод для других версий: app.subdomainOffset для смещения .subdomains для игнорирования [2]
Перевод Бреворда: app.subdomainOffset Смещение, которое необходимо игнорировать при расчете .subdomains [2]
В документации приведен пример subdomainOffset. Предположим, доменное имя «tobi.ferrets.example.com». Если app.subdomainOffset не установлен, что означает, что смещение по умолчанию для игнорирования равно 2, то ctx.subdomains равно ["ferrets", "tobi"].
- app.context is the prototype from which ctx is created from. You may add additional properties to ctx by editing app.context. This is useful for adding properties or methods to ctx to be used across your entire app, which may be more performant (no middleware) and/or easier (fewer require()s) at the expense of relying more on ctx, which could be considered an anti-pattern.
Перевод для других версий: app.context — это прототип, из которого создается ctx. Вы можете добавить другие свойства в ctx, отредактировав app.context. Это полезно для добавления ctx к свойствам или методам, используемым во всем приложении, что может быть более эффективным (не требуется промежуточного программного обеспечения) и/или проще (меньше require()) и более зависимым от ctx, что можно считать анти-шаблоном. .
Перевод Бреворда: app.context — это прототип ctx. Чтобы добавить больше свойств в ctx, вы можете изменить app.context. Это очень полезно для настройки некоторых свойств и методов ctx, которые можно использовать глобально в приложении, они обладают высокой производительностью (без промежуточного программного обеспечения) и проще (меньше требуют()). Недостатком является слишком большая зависимость от ctx, что можно считать анти-шаблоном.
Context
- overwrite a boolean indicating whether to overwrite previously set cookies of the same name (false by default). If this is true, all cookies set during the same request with the same name (regardless of path or domain) are filtered out of the Set-Cookie header when setting this cookie.
Переводы для других версий:
overwrite Логическое значение, указывающее, следует ли перезаписывать ранее установленные файлы cookie с тем же именем (по умолчанию — false). Если true, установить все файлы cookie с тем же именем в одном запросе (независимо от пути или домена), установить ли этот файл cookie из Set- Отфильтруйте заголовок Cookie.
Перевод слова Бреворд:
перезаписать: логическое значение, указывающее, следует ли перезаписывать ранее установленный файл cookie с тем же именем (по умолчанию — false). Если установлено значение true, установленный файл cookie перезапишет файл cookie с тем же именем в том же запросе (независимо от того, совпадают ли путь или доменное имя), то есть поле заголовка Set-Cookie отфильтрует ранее установленный файл cookie. .
Request
- request.querystring: Get raw query string void of ?.
Переводы для других версий: получить исходную строку запроса на основе ?.
Перевод Breword: получить исходную строку запроса без ? (т. е. строку запроса после ?).
лишенный означает «без».
- request.search: Get raw query string with the ?.
Переводы для других версий: используйте ?, чтобы получить исходную строку запроса.
Перевод Бреворда: получить исходную строку запроса, эту строку с символом ?.
«С» здесь означает не «через какой инструмент», а «с». Это поле также описано в исходном коде.
Response
response.flushHeaders()
Flush any set headers, and begin the body.
Другие варианты перевода: Обновите любые установленные заголовки и начните тему.
Перевод Бреворда: сбросьте все установленные поля заголовка и начните отправлять тело обратно клиенту.
Чтобы лучше понять это поле, мы ознакомились с официальной документацией node.js о request.flushHeaders().инструкция.
Так что смотрите на response.flushHeaders() соответственно, это значит, что серверу не нужно ждать тела, он может сначала отправить поле заголовка клиенту, а потом отправить тело.
Мы создали репозиторий на github для хранения документов с открытым исходным кодом, переведенных Breword. Добро пожаловать звезда. Breword/awesome-sync-to-Chinese