단축어의 '웹 페이지에서 JavaScript 실행' 동작에 관하여

웹 페이지 데이터 가져오기에 관하여

‘웹 페이지에서 JavaScript 실행’ 동작은 특정 조건에 일치하는 모든 요소를 가져오고 이러한 요소를 반복하여 데이터와의 작업을 수행함으로써(또는 요소를 추가 검사함으로써) 사용자가 웹 페이지에서 데이터를 가져올 수 있도록 합니다.

예를 들어 웹 페이지에서 모든 이미지 요소 목록을 생성하려면 다음을 사용하십시오.

var elements = document.querySelectorAll("img");

또 예를 들어 ‘post’ 클래스가 있는 모든 요소를 가져오려면 다음을 사용하십시오.

var elements = document.querySelectorAll(".post");

NodeList가 생성되면 다음과 같은 코드를 사용하여 요소들을 반복(요소를 추가로 필터링하거나 데이터 구조에 요소를 추가하여)할 수 있습니다.

웹 페이지 질의 결과에 대한 추가 정보를 보려면 https://developer.mozilla.org/Selectors 및 https://developer.mozilla.org/SelectorAll 사이트를 참조하십시오.

‘웹 페이지에서 JavaScript 실행’ 동작 입력

‘웹 페이지에서 JavaScript 실행’ 동작에 대한 입력은 활성 상태의 Safari 웹 페이지에 있어야 합니다. 이는 공유 시트(특히 Safari, SFSafariViewController 또는 ASWebAuthenticationSession에서)의 단축어 동작 확장 프로그램을 실행해야 함을 의미합니다.

단축어가 공유 시트에서 실행되면 Safari 앱에서의 입력은 단축어의 첫 번째 동작으로 전달됩니다.

'웹 페이지에서 JavaScript 실행' 동작으로 전달되는 입력은 반드시 Safari 웹 페이지여야 하지만, 매직 변수를 사용하여 동작에 데이터를 추가로 삽입할 수 있습니다. 예를 들어 다음 단축어는 웹 페이지의 비디오를 수정하는 ’웹 페이지에서 JavaScript 실행’ 동작을 포함합니다. 비디오 재생 속도는 속도 변수로 제어할 수 있습니다.

‘웹 페이지에서 JavaScript 실행’ 동작이 단축어의 첫 번째 동작이 아닌 경우, 단축어 실행 시 오류 메시지가 나타납니다.

이 문제를 해결하려면 ‘변수 가져오기’ 동작을 추가하고 Safari 웹 페이지가 ‘웹 페이지에서 JavaScript 실행’ 동작에 콘텐츠를 전달하도록 매개변수를 설정하십시오.

Safari에서 단축어 실행하기에 관한 추가 정보를 보려면 다른 앱에서 단축어 설정 및 실행하기를 참조하십시오.

‘웹 페이지에서 JavaScript 실행’ 동작 출력

데이터를 반환하려면 completion(result)와 같은 JavaScript에서 컴플리션 핸들러를 호출해야 합니다. JavaScript는 대게 비동기식 패턴으로 사용되므로 호출은 의도적으로 동기화되지 않습니다. 이렇게 하여 비동기적으로 동작을 완료할 수 있습니다. 예를 들어 다음 코드를 사용할 수 있습니다.

‘웹 페이지에서 JavaScript 실행’ 동작의 출력은 다음과 같은 유효한 JSON 데이터 유형이 될 수 있습니다.

• 문자열

• 숫자

• 불리언(참 또는 거짓)

• 배열(다른 모든 유효한 JSON 유형을 포함)

• 사전(다른 모든 유효한 JSON 유형을 포함)

• Null

• 정의되지 않음

JSON에 관한 추가 정보를 보려면, 단축어에서 JSON 사용에 관하여를 참조하십시오.

단축어 앱은 반환 값을 자동으로 인코딩 및 디코딩하여 JavaScript와 단축어 앱 간에 통신합니다. 이는 사용자가 컴플리션 핸들러를 호출하기 전에 JSON.stringify(result)를 호출하지 않아도 됨을 의미합니다.

반환 값이 JSON이므로 어떤 반환 값은 제대로 동작하지 않을 수 있습니다. 예를 들어 함수 또는 노드에 JSON으로 인코딩된 유용한 표현이 없을 수 있습니다. 이러한 경우 필요한 JSON 호환 값을 포함하는 배열/사전을 생성할 것을 권장합니다.

노드에 대한 추가 정보를 보려면 https://developer.mozilla.org/Node 사이트를 참조하십시오. 함수에 대한 추가 정보를 보려면 https://developer.mozilla.org/Functions 사이트를 참조하십시오.

‘웹 페이지에서 JavaScript 실행’ 동작에서 아무 데이터도 반환하지 않으려는 경우, 함수 내에 변수가 없는 completion()을 호출할 수 있습니다(undefined가 유효한 출력이기 때문에). 이는 completion(undefined)를 호출하는 것과 동일합니다.

‘웹 페이지에서 JavaScript 실행’ 동작 시간 제한

Safari의 모든 JavaScript 확장 프로그램처럼 ‘웹 페이지에서 JavaScript 실행’ 동작은 시간 제한이 적용되어 가능한 빠르게 수행되어야 합니다. 아래와 같이 동기 함수를 사용하는 JavaScript는 시간 안에 수행되지 못할 수 있습니다.

• window.alert()

• window.prompt()

• window.confirm()

• 몇 초 간의 시간 제한. 예: window.setTimeout(function() { completion(); }, 5000);

JavaScript가 시간 제한을 초과한 경우, 단축어를 실행하면 실행을 완료하지 못하고 JavaScript 시간 제한 오류 메시지가 표시됩니다.

구문 및 런타임 오류 처리하기

Safari에서 지원하는 모든 구문을 사용하여 ‘웹 페이지에서 JavaScript 실행’ 동작에 JavaScript를 쓸 수 있습니다. iOS 12는for of 루프 및 let 등의 ECMA 6 JavaScript 구문을 지원합니다.

단축어 앱에서 ‘웹 페이지에서 JavaScript 실행’ 동작은 사용자가 Safari 확장 프로그램에서 단축어를 실행하기 전에 기본 구문 검사를 수행하여 오류를 찾습니다.

텍스트 필드에 스크립트를 입력하면 구문이 하이라이트되어 해당 JavaScript의 유효성 여부를 확인할 수 있습니다. 예를 들어 문자열 끝에 물음표를 넣는 것을 잊은 경우, 해당 문자열 이후의 모든 텍스트가 하이라이트됩니다.

스크립트의 구문은 유효하지만 런타임 오류가 있는 경우, ‘웹 페이지에서 JavaScript 실행’ 동작이 예외를 잡아 표시합니다. 예를 들어 스크립트가 존재하지 않는 변수 또는 함수를 참조하는 경우(예: shortcuts.completion()), 런타임에 오류가 표시됩니다.

개인 정보 보호 및 보안

단축어가 웹 페이지에서 Javascript를 실행하는 것을 허용하면, 단축어는 민감한 데이터를 포함하여 웹 페이지의 모든 정보에 접근할 수 있습니다. 단축어 앱은 JavaScript 단축어를 비공개적으로 안전하게 실행하는 몇 가지 방법을 사용합니다.

‘웹 페이지에서 JavaScript 실행’ 동작을 포함하는 단축어를 실행하면 웹 페이지와 상호 작용함을 알리는 메시지가 표시됩니다. 이는 단축어가 암호, 전화번호 또는 신용 카드 정보와 같은 웹 페이지에 있는 민감한 데이터에 접근할 수 있음을 의미합니다.

허용을 탭하면 단축어가 지정된 웹 페이지에서 실행됩니다. 동일한 웹 페이지에서 동일한 단축어를 다시 실행하는 경우, 단축어 앱은 메시지를 다시 표시하지 않습니다. 이 허용 설정은 각 단축어별, 웹 페이지별로 유지됩니다.

단축어가 웹 페이지에 접근하도록 허용하면, 단축어 앱은 주기적으로 업데이트된 악성코드 정의를 다운로드하여 잠재적인 악성 스크립트로부터 사용자를 더 안전하게 보호하는 추가 단계를 취합니다. 웹 페이지와 상호 작용하기 전에, 단축어 앱은 JavaScript를 분석한 다음, 악성코드 정의를 참조합니다. 이 검사를 바탕으로, 단축어 실행을 허용하기 전에 추가적으로 메시지를 표시하거나, 스크립트를 거부 또는 허용하도록 단축어 앱에 지시합니다.

이 검사는 기기에서 수행됩니다. 즉, 분석을 위해 JavaScript의 콘텐츠(‘웹 페이지에서 JavaScript 실행’ 동작의 텍스트 필드에 있음)를 외부 서버에 전송하지 않습니다.

단축어의 실행되지 못하는 경우, 오류 설명 메시지가 표시됩니다.