Class InternalWebuntisSecretLoginPrivate

Hierarchy

Constructors

constructor

Properties

anonymous axios baseurl cookies id password school schoolbase64 sessionInformation username TYPES

Methods

_buildCookies _getCookieFromSetCookie _getJWT _otpLogin _request getAbsentLesson getClasses getDepartments getExamsForRange getHolidays getHomeWorkAndLessons getHomeWorksFor getInbox getLatestImportTime getLatestSchoolyear getNewsWidget getOwnClassTimetableFor getOwnClassTimetableForRange getOwnClassTimetableForToday getOwnTimetableFor getOwnTimetableForRange getOwnTimetableForToday getOwnTimetableForWeek getPdfOfAbsentLesson getRooms getSchoolyears getStatusData getStudents getSubjects getTeachers getTimegrid getTimetableFor getTimetableForRange getTimetableForToday getTimetableForWeek login logout validateSession convertDateToUntis convertUntisDate convertUntisTime

Constructors

constructor

Properties

anonymous

anonymous: boolean

axios

axios: AxiosInstance

baseurl

baseurl: string

cookies

cookies: string[]

id

id: string

password

password: string

school

school: string

schoolbase64

schoolbase64: string

sessionInformation

sessionInformation: null | SessionInformation

username

username: string

Static TYPES

TYPES: typeof WebUntisElementType = WebUntisElementType

Methods

Private _buildCookies

Private _getCookieFromSetCookie

  • _getCookieFromSetCookie(setCookieArray?: string[], cookieName??: string): undefined | string
  • Private

    Returns

    Parameters

    • Optional setCookieArray: string[]
    • Optional cookieName: string = 'JSESSIONID'

    Returns undefined | string

Private _getJWT

  • _getJWT(validateSession?: boolean): Promise<string>
  • Private

    Get JWT Token

    Parameters

    • validateSession: boolean = true

    Returns Promise<string>

_otpLogin

  • _otpLogin(token: string | number, username: string, time: number, skipSessionInfo?: boolean): Promise<SessionInformation>

  • Parameters

    • token: string | number
    • username: string
    • time: number
    • skipSessionInfo: boolean = false

    Returns Promise<SessionInformation>

Private _request

  • _request<Response>(method: string, parameter??: Record<string, any>, validateSession??: boolean, url??: string): Promise<Response>
  • Private

    Make a JSON RPC Request with the current session

    Returns

    Type Parameters

    • Response = Record<string, any>

    Parameters

    • method: string
    • Optional parameter: Record<string, any> = {}
    • Optional validateSession: boolean = true

      Whether the session should be checked first

    • Optional url: string = ...

    Returns Promise<Response>

getAbsentLesson

  • Returns all the Lessons where you were absent including the excused one!

    Returns

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional excuseStatusId: number = -1
    • Optional validateSession: boolean = true

    Returns Promise<Absences>

getClasses

  • Get all classes known by WebUntis

    Returns

    Parameters

    • Optional validateSession: boolean = true
    • schoolyearId: number

    Returns Promise<Klasse[]>

getDepartments

getExamsForRange

  • Get Exams for range

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • klasseId: number = -1
    • withGrades: boolean = false
    • Optional validateSession: boolean = true

    Returns Promise<Exam[]>

getHolidays

  • Get all holidays known by WebUntis

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Holiday[]>

getHomeWorkAndLessons

  • TODO: Find out what type this function returns

    Returns

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional validateSession: boolean = true

    Returns Promise<any[]>

getHomeWorksFor

  • Returns

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional validateSession: boolean = true

    Returns Promise<Homework[]>

getInbox

getLatestImportTime

  • Get the time when WebUntis last changed its data

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<number>

getLatestSchoolyear

getNewsWidget

  • Get News Widget

    Returns

    see index.d.ts NewsWidget

    Parameters

    • date: Date
    • Optional validateSession: boolean = true

    Returns Promise<NewsWidget>

getOwnClassTimetableFor

  • Get the Timetable of your class for the given day Note: You can't use this with anonymous login

    Returns

    Parameters

    • date: Date
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnClassTimetableForRange

  • Get the Timetable of your class for a given Date range Note: You can't use this with anonymous login

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnClassTimetableForToday

  • Get the Timetable of your class for today Note: You can't use this with anonymous login

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnTimetableFor

  • Get your own Timetable for the given day Note: You can't use this with anonymous login

    Parameters

    • date: Date
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnTimetableForRange

  • Get your own timetable for a given Date range Note: You can't use this with anonymous login

    Returns

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnTimetableForToday

  • Get your own Timetable for the current day Note: You can't use this with anonymous login

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getOwnTimetableForWeek

  • Get the timetable for the current week for the current element from the web client API.

    Returns

    Parameters

    • date: Date

      one date in the week to query

    • Optional formatId: number = 1

      set to 1 to include teachers, 2 omits the teachers in elements response

    • Optional validateSession: boolean = true

    Returns Promise<WebAPITimetable[]>

getPdfOfAbsentLesson

  • Returns a URL to a unique PDF of all the lessons you were absent

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • Optional validateSession: boolean = true
    • Optional excuseStatusId: number = -1
    • Optional lateness: boolean = true
    • Optional absences: boolean = true
    • Optional excuseGroup: number = 2

    Returns Promise<string>

getRooms

  • Get all known rooms by WebUntis

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Room[]>

getSchoolyears

getStatusData

getStudents

  • Get all known students by WebUntis

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Student[]>

getSubjects

  • Get all known Subjects for the current logged-in user

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Subject[]>

getTeachers

  • Get all known teachers by WebUntis

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Teacher[]>

getTimegrid

  • Get the timegrid of current school

    Returns

    Parameters

    • Optional validateSession: boolean = true

    Returns Promise<Timegrid[]>

getTimetableFor

  • Get the timetable for a specific day for a specific element.

    Parameters

    • date: Date
    • id: number
    • type: number
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getTimetableForRange

  • Get the timetable for a given Date range for specific element

    Parameters

    • rangeStart: Date
    • rangeEnd: Date
    • id: number
    • type: number
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getTimetableForToday

  • Get the timetable of today for a specific element.

    Returns

    Parameters

    • id: number
    • type: number
    • Optional validateSession: boolean = true

    Returns Promise<Lesson[]>

getTimetableForWeek

  • Get the timetable for the current week for a specific element from the web client API.

    Parameters

    • date: Date

      one date in the week to query

    • id: number

      element id

    • type: number

      element type

    • Optional formatId: number = 1

      set to 1 to include teachers, 2 omits the teachers in elements response

    • Optional validateSession: boolean = true

    Returns Promise<WebAPITimetable[]>

login

  • Login with your credentials

    Notice: The server may revoke this session after less than 10min of idle.

    Untis says in the official docs:

    An application should always log out as soon as possible to free system resources on the server.

    Returns Promise<SessionInformation>

logout

  • Logout the current session

    Returns Promise<boolean>

validateSession

  • Checks if your current WebUntis Session is valid

    Returns Promise<boolean>

Static convertDateToUntis

  • Convert a JS Date Object to a WebUntis date string

    Returns

    Parameters

    • date: Date

    Returns string

Static convertUntisDate

  • Converts the untis date string format to a normal JS Date object

    Static

    Parameters

    • date: string

      Untis date string

    • Optional baseDate: Date = ...

    Returns Date

Static convertUntisTime

  • Convert a untis time string to a JS Date object

    Static

    Parameters

    • time: string | number

      Untis time string

    • Optional baseDate: Date = ...

    Returns Date

Settings

Member Visibility

Theme

Generated using TypeDoc