@robertying/thu-learn-lib 5.0.0 → 6.0.0

package/src/types.ts

@@ -1,5 +1,12 @@
 import type { CookieJar } from 'tough-cookie';
 
+/**
+ * A time as an ISO 8601 string in Beijing time with its offset, e.g. `2026-11-07T18:28:00+08:00`: `new Date(t)` and
+ * `dayjs(t)` read it as the right moment in any time zone. (A string the server sent in another shape is passed on as
+ * it is.)
+ */
+export type ServerTime = string;
+
 export type Fetch = typeof globalThis.fetch;
 export type Credential = {
   username?: string;
@@ -32,6 +39,9 @@ export enum FailReason {
   OPERATION_FAILED = 'operation failed',
   ERROR_SETTING_COOKIES = 'could not set cookies',
   REQUEST_TIMEOUT = 'request timed out',
+  /** a request got no answer at all (no connection, DNS or TLS failure, connection reset); the error is in `extra` */
+  NETWORK_ERROR = 'network error',
+  ERROR_REGISTRAR_AUTH = 'could not sign in to the registrar (zhjw.cic.tsinghua.edu.cn)',
 }
 
 export interface ApiError {
@@ -55,14 +65,16 @@ export enum ContentType {
   QUESTIONNAIRE = 'questionnaire',
 }
 
-interface IUserInfo {
+export interface UserInfo {
   name: string;
+  /**
+   * The department (for undergraduates, their 书院) as the homepage shows it, in the website language.
+   * `''` when there is none, including in English for departments without an English name (the page says `none`).
+   */
   department: string;
 }
 
-export type UserInfo = IUserInfo;
-
-interface ISemesterInfo {
+export interface SemesterInfo {
   id: string;
   startDate: string;
   endDate: string;
@@ -71,19 +83,20 @@ interface ISemesterInfo {
   type: SemesterType;
 }
 
-export type SemesterInfo = ISemesterInfo;
-
 export enum CourseType {
   STUDENT = 'student',
   TEACHER = 'teacher',
 }
 
-interface ICourseInfo {
+export interface CourseInfo {
   id: string;
   name: string;
   chineseName: string;
   englishName: string;
-  /** only with `getCourseList(..., { timeAndLocation: true })`; see `getCourseTimeAndLocation` */
+  /**
+   * only with `getCourseList(..., { timeAndLocation: true })`, and left out for a course whose request failed;
+   * see `getCourseTimeAndLocation`. Read an entry with `parseCourseMeeting`.
+   */
   timeAndLocation?: string[];
   url: string;
   teacherName: string;
@@ -93,9 +106,7 @@ interface ICourseInfo {
   courseType: CourseType;
 }
 
-export type CourseInfo = ICourseInfo;
-
-interface IRemoteFile {
+export interface RemoteFile {
   id: string;
   name: string;
   downloadUrl: string;
@@ -103,42 +114,39 @@ interface IRemoteFile {
   size: string;
 }
 
-export type RemoteFile = IRemoteFile;
-
-export interface INotification {
+/** a course notification as the list gives it, without its attachment */
+export interface CourseNotificationBase {
   id: string;
   title: string;
   content: string;
   hasRead: boolean;
   url: string;
   markedImportant: boolean;
-  publishTime: string;
+  publishTime: ServerTime;
   publisher: string;
-  expireTime?: string;
+  expireTime?: ServerTime;
   isFavorite: boolean;
   comment?: string;
   /** name of the attachment, if the notice has one; fetch it with `getNotificationAttachment` */
   attachmentName?: string;
 }
 
-export interface INotificationDetail {
+export interface CourseNotificationDetail {
   attachment?: RemoteFile;
 }
 
-export type Notification = INotification & INotificationDetail;
+export type CourseNotification = CourseNotificationBase & CourseNotificationDetail;
 
-interface IFileCategory {
+export interface FileCategory {
   id: string;
   title: string;
-  creationTime: Date;
+  creationTime: ServerTime;
 }
 
-export type FileCategory = IFileCategory;
-
-interface IFile {
-  /** previously `id2` */
+export interface CourseFile {
+  /** the id of this file entry in the course (`kjxxid`) */
   id: string;
-  /** previously `id` */
+  /** the id of the stored file (`wjid`), which the download and preview URLs use */
   fileId: string;
   /** note: will be unset when calling `getFileListByCategory` */
   category?: FileCategory;
@@ -148,8 +156,8 @@ interface IFile {
   size: string;
   title: string;
   description: string;
-  uploadTime: string;
-  publishTime: string;
+  uploadTime: ServerTime;
+  publishTime: ServerTime;
   downloadUrl: string;
   /** preview is not supported on all types of files, check before use */
   previewUrl: string;
@@ -158,16 +166,14 @@ interface IFile {
   visitCount: number;
   downloadCount: number;
   fileType: string;
-  /** for compatibility */
+  /** the same file as a `RemoteFile`, the shape attachments have */
   remoteFile: RemoteFile;
   /** could not get favorite or comment info when using `getFileList` or in TA mode */
   isFavorite?: boolean;
   comment?: string;
 }
 
-export type File = IFile;
-
-export interface IHomeworkStatus {
+export interface HomeworkStatus {
   submitted: boolean;
   graded: boolean;
 }
@@ -207,33 +213,34 @@ export enum HomeworkGradeLevel {
   F = 'F',
 }
 
-export interface IHomework extends IHomeworkStatus {
+/** a homework as the lists give it, without its detail */
+export interface HomeworkBase extends HomeworkStatus {
   id: string;
   /** @deprecated use `id` */
   studentHomeworkId: string;
   baseId: string;
   title: string;
-  deadline: string;
-  lateSubmissionDeadline?: string;
+  deadline: ServerTime;
+  lateSubmissionDeadline?: ServerTime;
   url: string;
   completionType: HomeworkCompletionType;
   submissionType: HomeworkSubmissionType;
   submitUrl: string;
-  submitTime?: string;
+  submitTime?: ServerTime;
   isLateSubmission: boolean;
   grade?: number;
   /** some homework has levels but not grades, like A/B/.../F */
   gradeLevel?: HomeworkGradeLevel;
-  gradeTime?: string;
+  gradeTime?: ServerTime;
   graderName?: string;
   gradeContent?: string;
   isFavorite: boolean;
-  favoriteTime?: string;
   comment?: string;
+  /** `[]` when there is none; `undefined` when the course's excellent homework list couldn't be fetched */
   excellentHomeworkList?: ExcellentHomework[];
 }
 
-export interface IHomeworkDetail {
+export interface HomeworkDetail {
   description?: string;
   /** attachment from teacher */
   attachment?: RemoteFile;
@@ -247,7 +254,7 @@ export interface IHomeworkDetail {
   gradeAttachment?: RemoteFile;
 }
 
-export type Homework = IHomework & IHomeworkDetail;
+export type Homework = HomeworkBase & HomeworkDetail;
 
 export enum HomeworkCompletionType {
   INDIVIDUAL = 1,
@@ -259,7 +266,8 @@ export enum HomeworkSubmissionType {
   OFFLINE = 0,
 }
 
-export interface IExcellentHomework {
+/** an excellent homework as the list gives it, without its detail */
+export interface ExcellentHomeworkBase {
   id: string;
   baseId: string;
   title: string;
@@ -272,18 +280,18 @@ export interface IExcellentHomework {
   };
 }
 
-export type ExcellentHomework = IExcellentHomework & IHomeworkDetail;
+export type ExcellentHomework = ExcellentHomeworkBase & HomeworkDetail;
 
-export interface IHomeworkTA {
+export interface HomeworkTA {
   id: string;
   index: number;
   title: string;
   description: string;
   publisherId: string;
-  publishTime: string;
-  startTime: string;
-  deadline: string;
-  lateSubmissionDeadline?: string;
+  publishTime: ServerTime;
+  startTime: ServerTime;
+  deadline: ServerTime;
+  lateSubmissionDeadline?: ServerTime;
   url: string;
   completionType: HomeworkCompletionType;
   submissionType: HomeworkSubmissionType;
@@ -292,40 +300,51 @@ export interface IHomeworkTA {
   unsubmittedCount: number;
 }
 
-export type HomeworkTA = IHomeworkTA;
+/**
+ * A file to upload in React Native, whose `FormData` takes the file's `uri` (and MIME `type`) instead of a `Blob`.
+ */
+export interface ReactNativeFile {
+  uri: string;
+  /** MIME type; `application/octet-stream` if left out */
+  type?: string;
+}
+
+/** The request `submitHomework` sends, from `getHomeworkSubmitRequest`, for sending with another HTTP client */
+export interface HomeworkSubmitRequest {
+  /** the submit URL, with the CSRF token */
+  url: string;
+  /** POST it as multipart form data */
+  body: FormData;
+}
 
-export interface IHomeworkSubmitAttachment {
+export interface HomeworkSubmitAttachment {
   filename: string;
-  content: Blob;
+  content: Blob | ReactNativeFile;
 }
 
-export interface IDiscussionBase {
+export interface DiscussionBase {
   id: string;
   title: string;
   publisherName: string;
-  publishTime: string;
+  publishTime: ServerTime;
   lastReplierName: string;
-  lastReplyTime: string;
+  lastReplyTime: ServerTime;
   visitCount: number;
   replyCount: number;
   isFavorite: boolean;
   comment?: string;
 }
 
-interface IDiscussion extends IDiscussionBase {
+export interface Discussion extends DiscussionBase {
   url: string;
   boardId: string;
 }
 
-export type Discussion = IDiscussion;
-
-interface IQuestion extends IDiscussionBase {
+export interface Question extends DiscussionBase {
   url: string;
   question: string;
 }
 
-export type Question = IQuestion;
-
 export enum QuestionnaireDetailType {
   SINGLE = 'dnx',
   MULTI = 'dox',
@@ -352,24 +371,23 @@ export enum QuestionnaireType {
   SURVEY = 'wj',
 }
 
-export interface IQuestionnaire {
+export interface Questionnaire {
   id: string;
   type: QuestionnaireType;
   title: string;
-  startTime: string;
-  endTime: string;
-  uploadTime: string;
+  startTime: ServerTime;
+  endTime: ServerTime;
+  uploadTime: ServerTime;
   uploaderId: string;
   uploaderName: string;
-  submitTime?: string;
+  submitTime?: ServerTime;
   isFavorite: boolean;
   comment?: string;
   url: string;
-  detail: QuestionnaireDetail[];
+  /** the questions; only for the questionnaires `getQuestionnaireList`'s `details` selects (by default all) */
+  detail?: QuestionnaireDetail[];
 }
 
-export type Questionnaire = IQuestionnaire;
-
 /** which items get their extra per-item requests: none (default), all, or those the predicate accepts */
 export type DetailSelector<T> = 'none' | 'all' | ((item: T) => boolean);
 
@@ -383,7 +401,7 @@ export interface HomeworkListOptions {
    * Which homework gets its detail (page + description JSON, 2 requests each); default `'none'`.
    * The same as calling `getHomeworkDetail` for those items.
    */
-  details?: DetailSelector<IHomework>;
+  details?: DetailSelector<HomeworkBase>;
 }
 
 export interface NotificationListOptions {
@@ -391,17 +409,27 @@ export interface NotificationListOptions {
    * Which notices with an attachment get it (1 request each); default `'none'`.
    * The same as calling `getNotificationAttachment` for those items.
    */
-  attachments?: DetailSelector<INotification>;
+  attachments?: DetailSelector<CourseNotificationBase>;
+}
+
+export interface QuestionnaireListOptions {
+  /**
+   * Which questionnaires get their questions (`detail`, 1 request each); default `'all'` (unlike the other lists, for
+   * compatibility). The same as calling `getQuestionnaireDetail` for those items.
+   */
+  details?: DetailSelector<Questionnaire>;
 }
 
 export interface AllContentsOptions<T extends ContentType> {
   courseType?: CourseType;
-  /** homework `details` or notification `attachments`, passed to each course's list */
+  /** homework or questionnaire `details`, or notification `attachments`, passed to each course's list */
   details?: T extends ContentType.HOMEWORK
-    ? DetailSelector<IHomework>
+    ? DetailSelector<HomeworkBase>
     : T extends ContentType.NOTIFICATION
-      ? DetailSelector<INotification>
-      : never;
+      ? DetailSelector<CourseNotificationBase>
+      : T extends ContentType.QUESTIONNAIRE
+        ? DetailSelector<Questionnaire>
+        : never;
 }
 
 export interface AllContentsResult<T extends ContentType> {
@@ -412,41 +440,37 @@ export interface AllContentsResult<T extends ContentType> {
 }
 
 export type ContentTypeMap = {
-  [ContentType.NOTIFICATION]: Notification;
-  [ContentType.FILE]: File;
+  [ContentType.NOTIFICATION]: CourseNotification;
+  [ContentType.FILE]: CourseFile;
   [ContentType.HOMEWORK]: Homework;
   [ContentType.DISCUSSION]: Discussion;
   [ContentType.QUESTION]: Question;
   [ContentType.QUESTIONNAIRE]: Questionnaire;
 };
 
-interface ICourseContent<T extends ContentType> {
+export interface CourseContent<T extends ContentType = ContentType> {
   [id: string]: ContentTypeMap[T][];
 }
 
-export type CourseContent<T extends ContentType = ContentType> = ICourseContent<T>;
-
-interface IFavoriteItem {
+export interface FavoriteItem {
   id: string;
   type: ContentType;
   title: string;
-  time: string;
+  time: ServerTime;
   state: string;
   /** extra message. For homework, this will be deadline (plus score if graded). It's too flexible and hard to parse so we leave it as is. */
   extra?: string;
   semesterId: string;
   courseId: string;
   pinned: boolean;
-  pinnedTime?: string;
+  pinnedTime?: ServerTime;
   comment?: string;
-  addedTime: string;
+  addedTime: ServerTime;
   /** for reference */
   itemId: string;
 }
 
-export type FavoriteItem = IFavoriteItem;
-
-interface ICommentItem {
+export interface CommentItem {
   id: string;
   type: ContentType;
   content: string;
@@ -454,12 +478,21 @@ interface ICommentItem {
   title: string;
   semesterId: string;
   courseId: string;
-  commentTime: string;
+  commentTime: ServerTime;
   /** for reference */
   itemId: string;
 }
 
-export type CommentItem = ICommentItem;
+/** one entry of a course's time and location, read by `parseCourseMeeting` */
+export interface CourseMeeting {
+  /** 1 (Monday) to 7 (Sunday) */
+  weekday: number;
+  /** the class period (大节), a key of `CLASS_PERIOD_TIMES` */
+  period: number;
+  /** the teaching weeks it happens in, from 1; `null` for every week */
+  weeks: number[] | null;
+  location: string;
+}
 
 export interface CalendarEvent {
   location: string;
@@ -484,7 +517,10 @@ export interface CalendarRange {
 export interface CalendarResult {
   /** events of every window that succeeded, in date order */
   events: CalendarEvent[];
-  /** windows that failed even after a retry; empty when the whole range was fetched */
+  /**
+   * windows that failed (after a retry, unless they timed out) or were skipped after repeated timeouts; empty when the
+   * whole range was fetched
+   */
   failedRanges: CalendarRange[];
 }
 

package/src/urls.ts

@@ -1,36 +1,31 @@
-import { FormData } from 'node-fetch-native';
-import type { ContentType, IHomeworkSubmitAttachment, QuestionnaireType } from './types.ts';
+import type { ContentType, QuestionnaireType } from './types.ts';
 import { CourseType, Language } from './types.ts';
 import { CONTENT_TYPE_MAP, getMkFromType } from './utils.ts';
 
+// URLs without parameters are constants; URLs with parameters, and form bodies (a new `FormData` each time), are
+// functions. Form bodies use the global `FormData`, which Node (22+) and React Native both have.
+
 export const ID_PREFIX = 'https://id.tsinghua.edu.cn';
 export const LEARN_PREFIX = 'https://learn.tsinghua.edu.cn';
 export const REGISTRAR_PREFIX = 'https://zhjw.cic.tsinghua.edu.cn';
 
 const MAX_SIZE = 200;
 
-export const ID_LOGIN = () => 'https://id.tsinghua.edu.cn/do/off/ui/auth/login/form/bb5df85216504820be7bba2b0ae1535b/0';
+export const ID_LOGIN = `${ID_PREFIX}/do/off/ui/auth/login/form/bb5df85216504820be7bba2b0ae1535b/0`;
 
-export const ID_LOGIN_CHECK = () => 'https://id.tsinghua.edu.cn/do/off/ui/auth/login/check';
+export const ID_LOGIN_CHECK = `${ID_PREFIX}/do/off/ui/auth/login/check`;
 
 export const LEARN_AUTH_ROAM = (ticket: string) =>
   `${LEARN_PREFIX}/b/j_spring_security_thauth_roaming_entry?ticket=${ticket}`;
 
-export const LEARN_LOGOUT = () => `${LEARN_PREFIX}/f/j_spring_security_logout`;
-
-export const LEARN_HOMEPAGE = (courseType: CourseType) => {
-  if (courseType === CourseType.STUDENT) {
-    return `${LEARN_PREFIX}/f/wlxt/index/course/student/`;
-  } else {
-    return `${LEARN_PREFIX}/f/wlxt/index/course/teacher/`;
-  }
-};
+export const LEARN_LOGOUT = `${LEARN_PREFIX}/f/j_spring_security_logout`;
 
-export const LEARN_STUDENT_COURSE_LIST_PAGE = () => `${LEARN_PREFIX}/f/wlxt/index/course/student/`;
+/** the homepage (course list) of a student or a teacher; login reads the CSRF token from the student one */
+export const LEARN_HOMEPAGE = (courseType: CourseType) => `${LEARN_PREFIX}/f/wlxt/index/course/${courseType}/`;
 
-export const LEARN_SEMESTER_LIST = () => `${LEARN_PREFIX}/b/wlxt/kc/v_wlkc_xs_xktjb_coassb/queryxnxq`;
+export const LEARN_SEMESTER_LIST = `${LEARN_PREFIX}/b/wlxt/kc/v_wlkc_xs_xktjb_coassb/queryxnxq`;
 
-export const LEARN_CURRENT_SEMESTER = () => `${LEARN_PREFIX}/b/kc/zhjw_v_code_xnxq/getCurrentAndNextSemester`;
+export const LEARN_CURRENT_SEMESTER = `${LEARN_PREFIX}/b/kc/zhjw_v_code_xnxq/getCurrentAndNextSemester`;
 
 export const LEARN_COURSE_LIST = (semester: string, courseType: CourseType, lang: Language) =>
   courseType === CourseType.STUDENT
@@ -86,37 +81,10 @@ export const LEARN_NOTIFICATION_DETAIL = (courseID: string, notificationID: stri
     ? `${LEARN_PREFIX}/f/wlxt/kcgg/wlkc_ggb/student/beforeViewXs?wlkcid=${courseID}&id=${notificationID}`
     : `${LEARN_PREFIX}/f/wlxt/kcgg/wlkc_ggb/teacher/beforeViewJs?wlkcid=${courseID}&id=${notificationID}`;
 
-export const LEARN_NOTIFICATION_EDIT = (courseType: CourseType): string =>
-  `${LEARN_PREFIX}/b/wlxt/kcgg/wlkc_ggb/${courseType}/editKcgg`;
-
 export const LEARN_HOMEWORK_LIST_NEW = `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/zyListWj`;
 export const LEARN_HOMEWORK_LIST_SUBMITTED = `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/zyListYjwg`;
 export const LEARN_HOMEWORK_LIST_GRADED = `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/zyListYpg`;
 export const LEARN_HOMEWORK_LIST_EXCELLENT = `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/yxzylist`;
-export const LEARN_HOMEWORK_LIST_SOURCE = [
-  {
-    url: LEARN_HOMEWORK_LIST_NEW,
-    status: {
-      submitted: false,
-      graded: false,
-    },
-  },
-  {
-    url: LEARN_HOMEWORK_LIST_SUBMITTED,
-    status: {
-      submitted: true,
-      graded: false,
-    },
-  },
-  {
-    url: LEARN_HOMEWORK_LIST_GRADED,
-    status: {
-      submitted: true,
-      graded: true,
-    },
-  },
-];
-
 export const LEARN_HOMEWORK_PAGE = (courseID: string, id: string) =>
   `${LEARN_PREFIX}/f/wlxt/kczy/zy/student/viewCj?wlkcid=${courseID}&xszyid=${id}`;
 
@@ -131,29 +99,10 @@ export const LEARN_HOMEWORK_DETAIL_FORM_DATA = (baseId: string) => {
   return form;
 };
 
-export const LEARN_HOMEWORK_DOWNLOAD = (courseID: string, attachmentID: string) =>
-  `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/downloadFile/${courseID}/${attachmentID}`;
-
 export const LEARN_HOMEWORK_SUBMIT_PAGE = (courseID: string, id: string) =>
   `${LEARN_PREFIX}/f/wlxt/kczy/zy/student/tijiao?wlkcid=${courseID}&xszyid=${id}`;
 
-export const LEARN_HOMEWORK_SUBMIT = () => `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/tjzy`;
-
-export const LEARN_HOMEWORK_SUBMIT_FORM_DATA = (
-  id: string,
-  content = '',
-  attachment?: IHomeworkSubmitAttachment,
-  removeAttachment = false,
-) => {
-  const form = new FormData();
-  form.append('xszyid', id);
-  form.append('zynr', content ?? '');
-  if (attachment) form.append('fileupload', attachment.content, attachment.filename);
-  else form.append('fileupload', 'undefined');
-  if (removeAttachment) form.append('isDeleted', '1');
-  else form.append('isDeleted', '0');
-  return form;
-};
+export const LEARN_HOMEWORK_SUBMIT = `${LEARN_PREFIX}/b/wlxt/kczy/zy/student/tjzy`;
 
 export const LEARN_HOMEWORK_LIST_TEACHER = `${LEARN_PREFIX}/b/wlxt/kczy/zy/teacher/pageList`;
 
@@ -247,7 +196,7 @@ export const REGISTRAR_TICKET_FORM_DATA = () => {
   return form;
 };
 
-export const REGISTRAR_TICKET = () => `${LEARN_PREFIX}/b/wlxt/common/auth/gnt`;
+export const REGISTRAR_TICKET = `${LEARN_PREFIX}/b/wlxt/common/auth/gnt`;
 
 export const REGISTRAR_AUTH = (ticket: string) => `${REGISTRAR_PREFIX}/j_acegi_login.do?url=/&ticket=${ticket}`;
 

package/src/user.ts

@@ -1,18 +1,28 @@
 // User info and website language.
 
 import type { Session } from './request.ts';
-import { $ } from './request.ts';
-import type { UserInfo, Language } from './types.ts';
-import { CourseType } from './types.ts';
+import { discard } from './request.ts';
+import type { Language, UserInfo } from './types.ts';
+import { CourseType, FailReason } from './types.ts';
 import * as URLS from './urls.ts';
+import { $, apiError } from './utils.ts';
 
-/** get user's name and department */
+/** what the English homepage shows for a department without an English name (as for the 书院) */
+const NO_DEPARTMENT = 'none';
+
+/**
+ * get user's name and department (`''` if the page shows none)
+ *
+ * The homepage's profile card (`.fl.up-img-info`) has two `<p>`: the name and role labels (同学 / Student), then the
+ * department label (for undergraduates, their 书院). The name is also in the header's `a.user-log`.
+ */
 export async function getUserInfo(s: Session, courseType = CourseType.STUDENT): Promise<UserInfo> {
-  const content = await (await s.fetchWithToken(URLS.LEARN_HOMEPAGE(courseType))).text();
+  const content = await s.fetchTextWithToken(URLS.LEARN_HOMEPAGE(courseType));
 
   const dom = $(content);
   const name = dom('a.user-log').text().trim();
-  const department = dom('.fl.up-img-info p:nth-child(2) label').text().trim();
+  const label = dom('.fl.up-img-info p:nth-child(2) label').text().trim();
+  const department = label.toLowerCase() === NO_DEPARTMENT ? '' : label;
 
   return {
     name,
@@ -21,8 +31,13 @@ export async function getUserInfo(s: Session, courseType = CourseType.STUDENT):
 }
 
 export async function setLanguage(s: Session, lang: Language): Promise<void> {
-  await s.fetchWithToken(URLS.LEARN_WEBSITE_LANGUAGE(lang), {
+  const response = await s.fetchWithToken(URLS.LEARN_WEBSITE_LANGUAGE(lang), {
     method: 'POST',
   });
+  // free the connection; only the status matters
+  discard(response);
+  if (!response.ok) {
+    throw apiError(FailReason.OPERATION_FAILED, { code: response.status, text: response.statusText });
+  }
   s.lang = lang;
 }