flask/examples/javascript
David Lord 9cb1a7a52d
blinker is required, signals are always available
2023-04-13 07:39:24 -07:00
..
js_example stop ignoring flake8 e402 2023-01-19 06:35:15 -08:00
tests remove javascript fetch polyfill 2022-06-08 07:30:29 -07:00
.gitignore update docs and examples for pyproject 2023-01-18 10:32:51 -08:00
LICENSE.rst move package metadata to setup.cfg 2020-04-04 14:50:21 -07:00
MANIFEST.in move package metadata to setup.cfg 2020-04-04 14:50:21 -07:00
README.rst update docs and examples for pyproject 2023-01-18 10:32:51 -08:00
pyproject.toml blinker is required, signals are always available 2023-04-13 07:39:24 -07:00

README.rst

JavaScript Ajax Example
=======================

Demonstrates how to post form data and process a JSON response using
JavaScript. This allows making requests without navigating away from the
page. Demonstrates using |fetch|_, |XMLHttpRequest|_,  and
|jQuery.ajax|_. See the `Flask docs`_ about JavaScript and Ajax.

.. |fetch| replace:: ``fetch``
.. _fetch: https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch

.. |XMLHttpRequest| replace:: ``XMLHttpRequest``
.. _XMLHttpRequest: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest

.. |jQuery.ajax| replace:: ``jQuery.ajax``
.. _jQuery.ajax: https://api.jquery.com/jQuery.ajax/

.. _Flask docs: https://flask.palletsprojects.com/patterns/jquery/


Install
-------

.. code-block:: text

    $ python3 -m venv .venv
    $ . .venv/bin/activate
    $ pip install -e .


Run
---

.. code-block:: text

    $ flask --app js_example run

Open http://127.0.0.1:5000 in a browser.


Test
----

.. code-block:: text

    $ pip install -e '.[test]'
    $ coverage run -m pytest
    $ coverage report