Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка JSValueRef.h

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка JSValueRef.h

Включенные заголовки

  • <JavaScriptCore/JSBase.h>

  • <JavaScriptCore/WebKitAvailability.h>

  • <stdbool.h>

Функции

  • Создает строку JavaScript, содержащую сериализированное представление JSON значения JS.

    Объявление

    Swift

    func JSValueCreateJSONString(_ ctx: JSContext!, _ value: JSValue!, _ indent: UInt32, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Unmanaged<JSString>!

    Objective C

    JSStringRef JSValueCreateJSONString ( JSContextRef ctx, JSValueRef value, unsigned int indent, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    Значение для сериализации.

    indent

    Число пробелов для расположения с отступом, когда вложение. Если 0, получающийся JSON не будет содержать новые строки. Размер отступа фиксируется к 10 пробелам.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    JSString с результатом сериализации или NULL, если выдается исключение.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает тип значения JavaScript.

    Объявление

    Swift

    func JSValueGetType(_ ctx: JSContext!, _ value: JSValue!) -> JSType

    Objective C

    JSType JSValueGetType ( JSContextRef ctx, JSValueRef );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue, тип которого Вы хотите получить.

    Возвращаемое значение

    Значение типа JSType, идентифицирующий тип значения.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript булевым типом.

    Объявление

    Swift

    func JSValueIsBoolean(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsBoolean ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является булевым типом, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, равны ли два значения JavaScript, как сравнено JS == оператор.

    Объявление

    Swift

    func JSValueIsEqual(_ ctx: JSContext!, _ a: JSValue!, _ b: JSValue!, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Bool

    Objective C

    bool JSValueIsEqual ( JSContextRef ctx, JSValueRef a, JSValueRef b, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    a

    Первое значение, которое протестирует.

    b

    Второе значение для тестирования.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    истина, если два значения являются равными, ложными, если они не равны или исключение, брошена.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли значение JavaScript объектом, созданным данным конструктором, как сравнено оператором instanceof JS.

    Объявление

    Swift

    func JSValueIsInstanceOfConstructor(_ ctx: JSContext!, _ value: JSValue!, _ constructor: JSObject!, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Bool

    Objective C

    bool JSValueIsInstanceOfConstructor ( JSContextRef ctx, JSValueRef value, JSObjectRef constructor, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    constructor

    Конструктор для тестирования против.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    истина, если значение является объектом, созданным конструктором, как сравнено оператором instanceof JS, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript нулевым типом.

    Объявление

    Swift

    func JSValueIsNull(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsNull ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является нулевым типом, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript типом числа.

    Объявление

    Swift

    func JSValueIsNumber(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsNumber ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является типом числа, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript типом объекта.

    Объявление

    Swift

    func JSValueIsObject(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsObject ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является типом объекта, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли значение JavaScript объектом с данным классом в его цепочке класса.

    Объявление

    Swift

    func JSValueIsObjectOfClass(_ ctx: JSContext!, _ value: JSValue!, _ jsClass: JSClass!) -> Bool

    Objective C

    bool JSValueIsObjectOfClass ( JSContextRef ctx, JSValueRef value, JSClassRef jsClass );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    jsClass

    JSClass для тестирования против.

    Возвращаемое значение

    истина, если значение является объектом и имеет jsClass в его цепочке класса, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, являются ли два значения JavaScript строгими равный, как сравнено JS === оператор.

    Объявление

    Swift

    func JSValueIsStrictEqual(_ ctx: JSContext!, _ a: JSValue!, _ b: JSValue!) -> Bool

    Objective C

    bool JSValueIsStrictEqual ( JSContextRef ctx, JSValueRef a, JSValueRef b );

    Параметры

    ctx

    Контекст выполнения для использования.

    a

    Первое значение, которое протестирует.

    b

    Второе значение для тестирования.

    Возвращаемое значение

    истина, если два значения строги равный, иначе ложный.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript строковым типом.

    Объявление

    Swift

    func JSValueIsString(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsString ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является строковым типом, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Тесты, является ли тип значения JavaScript неопределенным типом.

    Объявление

    Swift

    func JSValueIsUndefined(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueIsUndefined ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для тестирования.

    Возвращаемое значение

    истина, если тип значения является неопределенным типом, иначе ложь.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает ценность JavaScript булева типа.

    Объявление

    Swift

    func JSValueMakeBoolean(_ ctx: JSContext!, _ boolean: Bool) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeBoolean ( JSContextRef ctx, bool boolean );

    Параметры

    ctx

    Контекст выполнения для использования.

    boolean

    bool для присвоения к недавно создаваемому JSValue.

    Возвращаемое значение

    JSValue булева типа, представляя значение булевской переменной.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает ценность JavaScript от отформатированной строки JSON.

    Объявление

    Swift

    func JSValueMakeFromJSONString(_ ctx: JSContext!, _ string: JSString!) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeFromJSONString ( JSContextRef ctx, JSStringRef string );

    Параметры

    ctx

    Контекст выполнения для использования.

    string

    JSString, содержащие JSON, представляют в виде строки, чтобы быть проанализированными.

    Возвращаемое значение

    JSValue, содержащий проанализированное значение или NULL, если ввод недопустим.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.7 и позже.

  • Создает ценность JavaScript нулевого типа.

    Объявление

    Swift

    func JSValueMakeNull(_ ctx: JSContext!) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeNull ( JSContextRef ctx );

    Параметры

    ctx

    Контекст выполнения для использования.

    Возвращаемое значение

    Уникальное нулевое значение.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает ценность JavaScript типа числа.

    Объявление

    Swift

    func JSValueMakeNumber(_ ctx: JSContext!, _ number: Double) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeNumber ( JSContextRef ctx, double number );

    Параметры

    ctx

    Контекст выполнения для использования.

    number

    Двойное для присвоения к недавно создаваемому JSValue.

    Возвращаемое значение

    JSValue типа числа, представляя значение числа.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает ценность JavaScript строкового типа.

    Объявление

    Swift

    func JSValueMakeString(_ ctx: JSContext!, _ string: JSString!) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeString ( JSContextRef ctx, JSStringRef string );

    Параметры

    ctx

    Контекст выполнения для использования.

    string

    JSString для присвоения к недавно создаваемому JSValue. Недавно создаваемый JSValue сохраняет строку и выпускает ее после сборки «мусора».

    Возвращаемое значение

    JSValue строкового типа, представляя значение строки.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Создает ценность JavaScript неопределенного типа.

    Объявление

    Swift

    func JSValueMakeUndefined(_ ctx: JSContext!) -> Unmanaged<JSValue>!

    Objective C

    JSValueRef JSValueMakeUndefined ( JSContextRef ctx );

    Параметры

    ctx

    Контекст выполнения для использования.

    Возвращаемое значение

    Уникальное неопределенное значение.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Защищает значение JavaScript от сборки «мусора».

    Объявление

    Swift

    func JSValueProtect(_ ctx: JSContext!, _ value: JSValue!)

    Objective C

    void JSValueProtect ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для защиты.

    Обсуждение

    Используйте этот метод, когда Вы хотите сохранить JSValue в глобальной переменной или на «куче», где сборщик «мусора» не будет в состоянии обнаружить Вашу ссылку на него.

    Значение может быть защищено многократно и должно быть незащищено равное количество времен прежде, чем стать имеющим право на сборку «мусора».

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Преобразовывает значение JavaScript в булевскую переменную и возвращает получающуюся булевскую переменную.

    Объявление

    Swift

    func JSValueToBoolean(_ ctx: JSContext!, _ value: JSValue!) -> Bool

    Objective C

    bool JSValueToBoolean ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для преобразования.

    Возвращаемое значение

    Булев результат преобразования.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Преобразовывает значение JavaScript в число и возвращает получающееся число.

    Объявление

    Swift

    func JSValueToNumber(_ ctx: JSContext!, _ value: JSValue!, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Double

    Objective C

    double JSValueToNumber ( JSContextRef ctx, JSValueRef value, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для преобразования.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    Числовой результат преобразования или NaN, если выдается исключение.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Преобразовывает значение JavaScript для возражения и возвращает полученный объект.

    Объявление

    Swift

    func JSValueToObject(_ ctx: JSContext!, _ value: JSValue!, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Unmanaged<JSObject>!

    Objective C

    JSObjectRef JSValueToObject ( JSContextRef ctx, JSValueRef value, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для преобразования.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    Результат JSObject преобразования или NULL, если выдается исключение.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Преобразовывает значение JavaScript для строкового представления и копирует результат в строку JavaScript.

    Объявление

    Swift

    func JSValueToStringCopy(_ ctx: JSContext!, _ value: JSValue!, _ exception: UnsafeMutablePointer<Unmanaged<JSValue>?>) -> Unmanaged<JSString>!

    Objective C

    JSStringRef JSValueToStringCopy ( JSContextRef ctx, JSValueRef value, JSValueRef *exception );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для преобразования.

    exception

    Указатель на JSValueRef, в котором можно сохранить исключение, если таковые имеются. Передайте NULL, если Вы не хотите сохранить исключение.

    Возвращаемое значение

    JSString с результатом преобразования или NULL, если выдается исключение. Владение соблюдает Создать Правило.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

  • Оставляет значение JavaScript без защиты от сборки «мусора».

    Объявление

    Swift

    func JSValueUnprotect(_ ctx: JSContext!, _ value: JSValue!)

    Objective C

    void JSValueUnprotect ( JSContextRef ctx, JSValueRef value );

    Параметры

    ctx

    Контекст выполнения для использования.

    value

    JSValue для снятия защиты.

    Обсуждение

    Значение может быть защищено многократно и должно быть незащищено равное количество времен прежде, чем стать имеющим право на сборку «мусора».

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.

Типы данных

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Постоянная идентификация типа JSValue.

    Объявление

    Swift

    struct JSType { init(_ value: UInt32) var value: UInt32 }

    Objective C

    typedef enum { kJSTypeUndefined, kJSTypeNull, kJSTypeBoolean, kJSTypeNumber, kJSTypeString, kJSTypeObject } JSType;

    Константы

    • kJSTypeUndefined

      kJSTypeUndefined

      Уникальное неопределенное значение.

      Доступный в OS X v10.5 и позже.

    • kJSTypeNull

      kJSTypeNull

      Уникальное нулевое значение.

      Доступный в OS X v10.5 и позже.

    • kJSTypeBoolean

      kJSTypeBoolean

      Примитивное булево значение, одна из истины или лжи.

      Доступный в OS X v10.5 и позже.

    • kJSTypeNumber

      kJSTypeNumber

      Примитивное числовое значение.

      Доступный в OS X v10.5 и позже.

    • kJSTypeString

      kJSTypeString

      Примитивное строковое значение.

      Доступный в OS X v10.5 и позже.

    • kJSTypeObject

      kJSTypeObject

      Объектное значение (подразумевать, что этим JSValueRef является JSObjectRef).

      Доступный в OS X v10.5 и позже.

    Оператор импорта

    Objective C

    @import JavaScriptCore;

    Swift

    import JavaScriptCore

    Доступность

    Доступный в OS X v10.5 и позже.