JSON Support

Flask uses the built-in json module for handling JSON. It will use the current blueprint’s or application’s JSON encoder and decoder for easier customization. By default it handles some extra data types:

- datetime.datetime and datetime.date are serialized to RFC 822 strings. This is the same as the HTTP date format.
- decimal.Decimal is serialized to a string.
- uuid.UUID is serialized to a string.
- dataclasses.dataclass is passed to dataclasses.asdict().
- Markup (or any object with a __html__ method) will call the __html__ method to get a string.

Jinja’s |tojson filter is configured to use Flask’s dumps() function. The filter marks the output with |safe automatically. Use the filter to render data inside <script> tags.

<script>
    const names = {{ names|tosjon }};
    renderChart(names, {{ axis_data|tojson }});
</script>

flask.json.jsonify(*args, **kwargs)

Serialize data to JSON and wrap it in a Response with the application/json mimetype.

Uses dumps() to serialize the data, but args and kwargs are treated as data rather than arguments to json.dumps().

1. Single argument: Treated as a single value.
2. Multiple arguments: Treated as a list of values. jsonify(1, 2, 3) is the same as jsonify([1, 2, 3]).
3. Keyword arguments: Treated as a dict of values. jsonify(data=data, errors=errors) is the same as jsonify({"data": data, "errors": errors}).
4. Passing both arguments and keyword arguments is not allowed as it’s not clear what should happen.

from flask import jsonify

@app.route("/users/me")
def get_current_user():
    return jsonify(
        username=g.user.username,
        email=g.user.email,
        id=g.user.id,
    )

Will return a JSON response like this:

{
  "username": "admin",
  "email": "admin@localhost",
  "id": 42
}

The default output omits indents and spaces after separators. In debug mode or if JSONIFY_PRETTYPRINT_REGULAR is True, the output will be formatted to be easier to read.

Changelog

Parameters:
        - args (Any) –
        - kwargs (Any) –

Return type:  Response

JSON サポート

Flask は JSON を扱うために組み込みの json モジュールを使用します。より簡単にカスタマイズできるように、現在のブループリントやアプリケーションのJSONエンコーダとデコーダを使用します。デフォルトでは、いくつかの特別なデータ型を扱います。

- datetime.datetime と datetime.date は、RFC 822 文字列にシリアライズされます。これは、HTTPの日付形式と同じです。
- decimal.Decimalは、文字列にシリアライズされます。
- uuid.UUIDは、文字列にシリアライズされます。
- dataclasses.dataclassはdataclasses.asdict()に渡される【1】。
- Markup【2】 (または __html__ メソッドを持つオブジェクト) は __html__ メソッドを呼び出して文字列を取得します。

Jinja の |tojson フィルタは Flask の dumps() 関数を使用するように設定されています。このフィルタは、出力を自動的に |safe でマークします。<script>タグの中のデータをレンダリングするために、このフィルター【3】を使います。

<script> タグ内【4】
    const names = {{ names|tosjon }};
    renderChart(names, {{ axis_data|tojson }}) とします。【5】
</script>

flask.json.jsonify(*args, **kwargs)

データをJSONにシリアライズし、application/json mimetypeでResponseにラップ【6】します。

データのシリアライズには dumps() を使用しますが、args と kwargs は json.dumps() の引数ではなく、データとして扱われます。

1. 1. 単一の引数。1.【7】単一引数：単一の値として扱われます。
2. 2. 複数の引数。【8】 jsonify(1, 2, 3)はjsonify([1, 2, 3])と同じ意味です。
3. 3. キーワード引数。【9】 jsonify(data=data, errors=errors) は jsonify({"data": data, "errors": errors})と同じです。
4. 4. 引数とキーワード引数の両方を渡すことは、何が起こるか分からないので禁止されています。

from flask import jsonify

@app.route("/users/me")
def get_current_user():
    return jsonify(
        username=g.user.username,
        email=g.user.email。【10】
        id=g.user.id,
    )

このようなJSONレスポンスが返されます。

{
  "username": "admin",
  "email": "admin@localhost",
  "id": 42
}

デフォルトの出力では、セパレータの後のインデントとスペースは省略されます。デバッグモードまたは JSONIFY_PRETTYPRINT_REGULAR が True の場合、出力は読みやすいようにフォーマットされます。

変更履歴

パラメータ
        - args (任意【11】)
        - kwargs (任意)

戻り値のタイプ【12】  レスポンス【13】

JSON Support

Flask uses the built-in json module for handling JSON. It will use the current blueprint’s or application’s JSON encoder and decoder for easier customization. By default it handles some extra data types:

- datetime.datetime and datetime.date are serialized to RFC 822 strings. This is the same as the HTTP date format.
- decimal.Decimal is serialized to a string.
- uuid.UUID is serialized to a string.
- dataclasses.dataclass is passed to dataclasses.asdict().
- Markup (or any object with a __html__ method) will call the __html__ method to get a string.

Jinja’s |tojson filter is configured to use Flask’s dumps() function. The filter marks the output with |safe automatically. Use the filter to render data inside <script> tags.

<script>
    const names = {{ names|tosjon }};
    renderChart(names, {{ axis_data|tojson }});
</script>

flask.json.jsonify(*args, **kwargs)

Serialize data to JSON and wrap it in a Response with the application/json mimetype.

Uses dumps() to serialize the data, but args and kwargs are treated as data rather than arguments to json.dumps().

1. Single argument: Treated as a single value.
2. Multiple arguments: Treated as a list of values. jsonify(1, 2, 3) is the same as jsonify([1, 2, 3]).
3. Keyword arguments: Treated as a dict of values. jsonify(data=data, errors=errors) is the same as jsonify({"data": data, "errors": errors}).
4. Passing both arguments and keyword arguments is not allowed as it’s not clear what should happen.

from flask import jsonify

@app.route("/users/me")
def get_current_user():
    return jsonify(
        username=g.user.username,
        email=g.user.email,
        id=g.user.id,
    )

Will return a JSON response like this:

{
  "username": "admin",
  "email": "admin@localhost",
  "id": 42
}

The default output omits indents and spaces after separators. In debug mode or if JSONIFY_PRETTYPRINT_REGULAR is True, the output will be formatted to be easier to read.

Changelog

Parameters:
        - args (Any) –
        - kwargs (Any) –

Return type:  Response

JSON のサポート

Flask は、組み込みの json モジュールを使用して JSON を処理します。カスタマイズを容易にするために、現在のブループリントまたはアプリケーションの JSON エンコーダーとデコーダーを使用します。デフォルトでは、いくつかの追加のデータ型を処理します:

- datetime.datetime と datetime.date は、RFC 822 文字列にシリアル化されます。これは、HTTP 日付形式と同じです。
- decimal.Decimal は文字列にシリアル化されます。
- uuid.UUID は文字列にシリアル化されます。
- dataclasses.dataclass は dataclasses.asdict() に渡されます。
- マークアップ (または __html__ メソッドを持つ任意のオブジェクト) は、__html__ メソッドを呼び出して文字列を取得します。

Jinja の |tojson フィルターは、Flask の dumps() 関数を使用するように構成されています。フィルター【1】は、出力に |safe のマークを自動的に付けます。 <script> タグ内のデータをレンダリングするには、フィルター【1】を使用します。

<スクリプト>【2】
    const 名【3】 = {{ 名【3】|tosjon }};
    renderChart(names, {{ axis_data|tojson }});
</script>

フラスコ【4】.json.jsonify(*args, **kwargs)

データを JSON にシリアライズし、それを application/json mimetype の Response にラップ【5】 します。

dumps() を使用してデータをシリアル化しますが、args と kwargs は json.dumps() への引数ではなくデータとして扱われます。

1. 単一の引数: 単一の値として扱われます。
2. 複数の引数: 値のリストとして扱われます。 jsonify(1, 2, 3) は jsonify([1, 2, 3]) と同じです。
3. キーワード引数: 値の辞書として扱われます。 jsonify(data=data, errors=errors) は jsonify({"data": data, "errors": errors}) と同じです。
4.何が起こるべきかが明確でないため、引数とキーワード引数の両方を渡すことは許可されていません。

フラスコインポートjsonifyから【6】

@app.route("/users/me")
デフォルト【7】 get_current_user():
    jsonify( を返す【8】
        ユーザー名=g.user.ユーザー名、【9】
        email=g.user.email,
        id=g.user.id,
    )

次のような JSON 応答が返されます。

{
  "ユーザー名": "管理者"【10】,
  "email": "admin@localhost",
  "id": 42
}

デフォルトの出力では、区切り記号の後のインデントとスペースが省略されます。デバッグ モードの場合、または JSONIFY_PRETTYPRINT_REGULAR が True の場合、出力は読みやすいように書式設定されます。

変更ログ

パラメーター：
        - 引数【11】 (任意【12】) -
        - kwargs (任意) –

戻り値の型: レスポンス【13】