Web API NRE Support

XMLHttpRequest NRE Support

개요

NRE 실행 시 XMLHttpRequest 오브젝트를 사용할 수 있습니다.
앱을 실행하는 운영체제에 따른 기능(속성, 메소드) 지원 여부를 설명합니다.

* WRE에서 브라우저, 버전에 따른 XMLHttpRequest 오브젝트 기능 지원 여부는 아래 링크를 참고하세요.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#browser_compatibility

* 각 기능 상세 정보는 아래 스펙 문서를 참고하세요.
https://xhr.spec.whatwg.org/

iOS/iPadOS NRE 사용 제약

앱 Packing 시 Update Type을 "Update" 또는 "Local"로 지정한 경우에는 XMLHttpRequest 오브젝트를 사용할 수 없습니다.
WKWebView 정책에 따라 로컬에 저장한 파일은 XMLHttpRequest 통신을 처리할 수 없습니다(실행 시 에러가 발생합니다).
아래 기능 지원 여부는 Update Type을 "Server"로 지정한 경우에만 해당합니다.

기능 지원 여부

아래 표에서 운영체제 NRE는 약어로 표시합니다.

W(Windows NRE), A(Android NRE), I(iOS/iPad NRE), M(macOS NRE)

Property

Value: State

W

A

I

M

Description

readyState

0: UNSENT

O

O

O

O


1: OPENED

O

O

O

O


2: HEADERS_RECEIVED

X

X

O

X


3: LOADING

O

O

O

X


4: DONE

O

O

O

O


status


O

O

O

O


onreadystatechange


O

O

O

O


responseURL


O

O

O

O

default 값은 빈 값으로 처리합니다.

response


O

O

O

O

반환값은 Text 형식만 지원합니다.

responseType


O

O

O

O


responseText


O

O

O

O

반환값은 Text 형식만 지원합니다.

Method

Parameter

W

A

I

M

Description

abort


O

O

O

O


getAllResponseHeaders


O

O

O

O


getResponseHeader


O

O

O

O


open

method

O

O

O

O

GET, POST, PUT, DELETE, HEAD, PATCH를 지원합니다.

url

O

O

O

O

prefix는 지원하지 않습니다.

[async = true]

O

O

O

O


[user = null]

X

X

O

X


[psw = null]

X

X

O

X


send


O

O

O

O

open의 method 파라미터값이 "GET", "HEAD"이면 Body는 null로 설정됩니다.

setRequestHeader


O

O

O

O


WebSocket NRE Support

개요

NRE 실행 시 WebSocket 오브젝트를 사용할 수 있습니다.
앱을 실행하는 운영체제에 따른 기능(속성, 메소드, 이벤트) 지원 여부를 설명합니다.

* WRE에서 브라우저, 버전에 따른 Websocket 오브젝트 기능 지원 여부는 아래 링크를 참고하세요.
https://developer.mozilla.org/en-US/docs/Web/API/WebSocket#browser_compatibility

* 각 기능 상세 정보는 아래 스펙 문서를 참고하세요.
https://html.spec.whatwg.org/multipage/web-sockets.html#the-websocket-interface

Windows NRE 사용 제약

- 윈도우 7 이상 운영체제만 지원합니다.
- 윈도우 7 운영체제에서 wss 프로토콜 통신 시도 시 사설 인증서를 적용한 서버는 접속할 수 없습니다.
- Constructor에서 protocols(optional) 파라미터는 지원하지 않습니다.

iOS/iPadOS NRE 사용 제약

앱 Packing 시 Update Type을 "Update" 또는 "Local"로 지정한 경우에는 WebSocket 오브젝트를 사용할 수 없습니다.
WKWebView 정책에 따라 로컬에 저장한 파일은 WebSocket 통신을 처리할 수 없습니다(실행 시 에러가 발생합니다).
아래 기능 지원 여부는 Update Type을 "Server"로 지정한 경우에만 해당합니다.

기능 지원 여부

아래 표에서 운영체제 NRE는 약어로 표시합니다.

W(Windows NRE), A(Android NRE), I(iOS/iPad NRE), M(macOS NRE)

Property

Value: State

W

A

I

M

Description

binaryType


O

O

O

O


bufferedAmount


X

O

O

O


extensions


X

O

O

O


protocol


X

O

O

O


readyState

0: CONNECTING

O

O

O

O


1: OPEN

O

O

O

O


2: CLOSING

O

O

O

O


3: CLOSED

O

O

O

O


url


O

O

O

O


onopen


O

O

O

O

event listener (open)

onmessage


O

O

O

O

event listener (message)

onerror


O

O

O

O

event listener (error)

onclose


O

O

O

O

event listener (close)

Method

Parameter

W

A

I

M

Description

close

code(optional)

O

O

O

O



reason(optional)

O

O

O

O


send

msg

O

O

O

O


- 정보 확인 시 e.type 형태로 속성값을 확인할 수 있습니다.

Event

Event Info

W

A

I

M

Description

open

type: "open"

O

O

O

O


message

type: "message'

O

O

O

O


data: 수신 메시지

O

O

O

O


error

type: "error"

O

O

O

O


close

type: "close"

O

O

O

O


code: Status Code

O

O

O

O

Status Code는 아래 표를 참고하세요.

reason: 종료 메시지

O

O

O

O


- 900, 901, 902, 920은 NRE에서만 지원하는 코드입니다.
  그 외 코드에 대한 정보는 https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent 를 참고하세요.
  지원 여부를 "N/A"로 표시한 경우는 Reserved 코드이거나 특정 운영체제에서만 지원하는 코드입니다.

Status Code

W

A

I

M

Description

900

O

N/A

N/A

N/A

WebSocket Server Connect Failed

901

O

N/A

N/A

N/A

WebSocket Failure to receive message

902

O

N/A

N/A

N/A

WebSocket Failed to send message

920

N/A

O

N/A

N/A

Neo Visionaries Package Error Reason

1000

O

O

O

O


1001

O

O

O

O


1002

O

O

O

O


1003

O

O

O

O


1004

X

N/A

O

N/A


1005

O

O

O

O


1006

O

O

O

O


1007

O

X

O

O


1008

O

X

O

X


1009

O

O

O

O


1010

O

X

O

X


1011

O

O

O

X


1012

X

X

O

X


1013

X

X

O

X


1014

O

O

O

X


1015

O

O

O

X